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INTRODUCTION 



This manual contains the reference information needed 
to develop and maintain applications software for the 
TEKTRONIX 4107 and 4109 Computer Display Terminals. 

Related manuals include: 

• The 4107/4109 Computer Display Terminal Operators 
Manual, which describes each terminal, its use, and the 
self-test features. 

9 The 4107/4109 Computer Display Terminal Reference 
Guide, which contains essential reference material in a 
condensed form. 

WHERE TO LOOK FOR INFORMATION 

This manual is organized as follows: 

• Section 1 , Introduction, contains introductory informa- 
tion about the terminal. 

• Section 2, Communications, discusses the concepts of 
terminal communications with a host computer and with 
the terminal's two-port peripheral interface, handshaking 
protocols, and reports. 



• Section 3, The Graphics Terminal, discusses basic termi- 
nal concepts that you wiii need to write applications 
programs for the terminal. Topics include dialog area, 
basic graphics concepts, graphics input (GIN), and color. 

• Section 4, Screen Editing, discusses text editing con- 
cepts. This section also contains the detailed command 
descriptions for the ANSI X3.64 and VT52 text editing 
commands, along with an explanation of the command 
syntax. 

• Section 5, 4100-Style Parameter Types, Commands, and 
Reports, contains an alphabetically organized dictionary 
of all terminal commands except Ansi and VT52 com- 
mands, along with an explanation of the command syn- 
tax used in this section. 

• Appendices include code charts for each character set 
and their keyboard macro numbers, reference lists of 
commands, the Tektronix Color Standard, examples of 
integer parameters, and an index. 
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FEATURES 

The following paragraphs describe the main features of the 
4107 and 41 09 terminals. 

The Display. The terminal incorporates a 60-Hz non- 
interlaced raster-scan display for flicker-free viewing. The 
4107 has a 13-inch display, and the 4109 has a 19-inch 
display. Each color crt has 640-by-480 pixel resolution. 

Alphanumerics. You can display uppercase and lowercase 
characters. The characters have definable attributes includ- 
ing character color, background character cell color, under- 
line, and blink. The characters are displayed in 7-by-9 dot 
matrices in a 8-by-1 5 dot character cell. 

Alternate Character Sets. You can select from eight alter- 
nate character sets. These sets are: ASCII, United King- 
dom, French, Swedish, Danish/Norwegian, German, a 
special supplementary character set, and a special rulings 
character set. 

Dialog Area. A user-definable dialog area displays host 
communications without interfering with the graphics on the 
screen. You can select a column width of 80 or 132 charac- 
ters, and you can adjust the area height from 2 to 32 lines. 
The dialog area's scrollable memory is adjustable from two 
to as many lines as memory permits. The dialog area can be 
made visible or invisible by host command or with the Dia- 
log key. 

Graphics Area. The graphics area is separate from the 
dialog area. This portion of the display is used for graphics 
information. 

Color. You can select from a palette of 64 distinct color 
mixtures on the 4107, and from a palette of 4096 distinct 
color mixtures on the 41 09. Up to 1 6 colors can be dis- 
played simultaneously in the graphics area, with an addi- 
tional 8 colors in the dialog area. Color can enhance the 
visual impact and the information content of both graphics 
and text, and adds a new dimension to text editing. 



Graphics. You can draw solid or dashed lines in color. You 
can fill panels with solid colors, color shading, or with a 
variety of patterns. You can add labels or text to the graph- 
ics in different sizes, colors, and rotation angles. A variety of 
capabilities provide for versatile graphics programming: 

• Segment operations allow you to define a group of graph- 
ics objects as a segment and manipulate this segment as 
a single entity. 

• Pixel operations allow the host to access and manipulate 
individual pixels on the color raster display. 

• Multiple graphics surfaces can be used for multi-level 
graphics applications such as architectural or circuit 
board design. 

• Graphtext commands allow user- or software-defined 
fonts for special display purposes. Graphtext can be 
scaled, rotated, or slanted in a variety of ways for cus- 
tom-designed graphics displays. 

Multiple Views. You can define up to 64 separate views, 
and use them to window in on different parts of the same 
display or on different displays. You can display different 
views simultaneously or in rapid succession. 

Zoom and Pan. The zoom and pan features allow you to 
examine different parts of a picture in detail or get a bird's- 
eye overall view of a picture. 

Graphics Input. An extensive set of graphics input (GIN) 
commands provide for interactive graphics with the host. 
You can use most graphics input application programs 
written for 4010 Series terminals without modification. 

Nonvolatile Memory. This portion of the terminal's memory 
lets you configure the terminal for a particular application 
and then save the operating parameters in a part of the 
terminal's memory that is not erased even when the power 
is turned off. When you turn the power on again, the termi- 
nal automatically remembers and uses the saved parameter 
values. 

Commands. The terminal has four types of commands, 
each designed for a particular purpose. (See Modes of 
Operation later in this section.) 
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Software Compatibility. The following software packages 
are compatible with this terminal: 

• TEKTRONIX Plot 1 Interactive Graphics Library 

• TEKTRONIX Plot 10 Easy Graphing II 

• SASGRAPH, from the SAS Institute, Inc 

• DISSPLA, from ISSCO (Integrated Software Systems 
Corporation) 

• Certain editing programs designed for use with VT1 00 or 
VT52 terminals, such as EDT, VI, and EMACS 

You can run most programs written for 401 Series 
terminals. 

Computer Interface. The terminal uses a full-duplex serial 
RS-232-C interface with data rates to 38400 baud. 

Color Hardcopy. The terminal is compatible with the 
TEKTRONIX 4695 Color Graphics Copier. 

Peripheral Ports. Two RS-232 peripheral ports allow you to 
connect several compatible Tektronix peripheral devices, 
including plotters and the 4957 Graphics Tablet for graphics 
input. 

Keyboard. The terminal has a low-profile detachable key- 
board. The keys include ASCII uppercase, lowercase, and 
control characters, BREAK and ERASE keys, a 14-key 
numeric keypad, and four special function keys and eight 
programmable function keys. Most keys have N-key 
rollover. All keys are programmable except Shift, Ctrl, 
and Caps Lock, and you can set all keys to repeat when 
held down for more than one-half second. 



THE TERMINAL'S PROGRAMMING MODEL 

You can configure the terminal to perform many different 
functions. Once you've set the operating parameters or 
characteristics of the terminal to best perform the desired 
function, you can save these parameters in the terminal's 
memory so that they are not erased when the terminal is 
turned off. In this way, the terminal can remain in the same 
configuration for as long as you want. 

This terminal is really two different terminals in one 
package: 

• A graphics display terminal that is compatible with Tek- 
tronix 4010 Series graphics applications programs. It 
also has an interactive color interface (used to adjust the 
terminal's color map or displayed colors), a scrollable 
dialog area that displays host communications while 
leaving the graphics display undisturbed, and a subset of 
the Tektronix 4110 command set. 

• A text entry and editing terminal that is compatible with 
the American National Standards Institute (ANSI) Stand- 
ard X3.64 and the International Organization for Stan- 
dardization (ISO) 6429 standards. These standards 
define a set of terminal functions that let you manipulate 
and edit computer text files. You can configure the termi- 
nal to run most popular screen editing programs. 
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Modes of Operation 

The terminal has four major modes of operation. In each 
mode the terminal accepts one type of command syntax that 
is recognized only in that mode. The modes are as follows: 

• Ansi mode. In this mode, the terminal understands the 
syntax of the ANSI X3.64 text editing commands only. 
One specific implementation of Ansi mode is Edit mode, 
in which the operating characteristics of the terminal 
have been set to specific values. The Screen Editing 
section of this manual contains a discussion of Ansi and 
Edit modes, and the descriptions of the ANSI commands. 

• Tek mode. In this mode, the terminal understands the 
syntax of the graphics and terminal control commands. 
The Graphics Terminal and 4100-Style Parameter Types, 
Commands, and Reports sections of this manual contain 
a discussion of this mode and descriptions of the com- 
mands available in this mode. For added versatility, the 
parameters set in Tek mode carry over, as appropriate, 
into Ansi mode; some parameters set in Ansi mode are 
also effective in Tek mode. 



• VT52 mode. In this mode, the terminal is compatible with 
programs using VT52-style commands. 

• Setup mode. In this mode, the terminal accepts Setup 
mode commands, which the user enters from the termi- 
nal keyboard. The Graphics Terminal and 4100-Style 
Parameter Types, Commands, and Reports sections of 
this manual contain a discussion of this mode and 
descriptions of the commands available in this mode. 

Figure 1 -1 shows these modes and what you can do in each 
one. 




Many command parameters in Tek mode must be 
encoded in special formats. See the introductory 
material in the 41 00-Style Parameter Types, Com- 
mands and Reports section of this manual for 
details. 
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Figure i-i. lerminai modes. 
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COMMUNICATIONS 



This section discusses basic concepts for communication 
between the terminal and a host computer or one of the 
terminal's peripheral ports. The topics covered are: 

• Host Communications Concepts 

• The Terminal's Input Queue and Handshaking Protocols 

• Requesting Reports From the Terminal 

• Port Communications 



HOST COMMUNICATIONS 
CONCEPTS 

This subsection explains basic host communications con- 
cepts. You can change the terminal's communications 
settings by sending commands from the host, or the opera- 
tor can change them by typing Setup mode commands on 
the keyboard. All communications parameters can be saved 
in the terminal's nonvolatile memory by the SAVE NON- 
VOLATILE PARAMETERS command; they are then remem- 
bered even if the terminal is turned off. 

The following paragraphs explain each communications 
concept; each discussion concludes by giving the descrip- 
tive name and the Setup name of the command used to 
change the terminal setting. 

BAUD RATES 

The baud rate is the rate in bits per second that the terminal 
transmits or receives data. For example, 2400 baud means 
data is transferred at the rate of 2400 bits per second. Com- 
munications with the host cannot take place unless the 
terminal's baud rates are set correctly. 

Descriptive name: SET BAUD RATES 
Setup name: BA UDRATE 



TRANSMIT RATE LIMITS 

You can specify a transmit rate limit — a maximum speed 
for terminal-to-host communications — which may be less 
than the baud rate specified by the SET BAUD RATES com- 
mand. A transmit rate limit of 300, for instance, means that 
the terminal, in sending characters to the host, will space 
those characters so that the average data rate is 300 bits 
per second. This limit is useful at high terminal-to-host baud 
rates, where the host computer cannot accept characters at 
the full data rate specified by the SET BAUD RATES 
command. 

Descriptive name: SET TRANSMIT RATE LIMIT 
Setup name: 



ECHO 

Unless the terminal is in Setup or Local mode, the charac- 
ters that you type on the keyboard are sent to the host. 
Characters that appear on the screen are realiy echoes of 
those typed characters. These echoes only appear if the 
host or modem sends the same characters back to the 
terminal (called remote echo) or the terminal provides its 

The terminal can be set for either local or remote echo with 
the SET ECHO command. If you set local echo when the 
host or modem already provides an echo, the operator wiil 
see double characters, LLIIKKEETTHHIISS. If you set 
remote echo but the host or modem does not provide an 
echo, typed characters will not appear on the screen. 

Descriptive name: SET ECHO 
Setup name: ECHO 
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FULL-DUPLEX DATA COMMUNICATIONS 



BREAK TIME 



The terminal uses full-duplex data communications. To use 
full-duplex data communications with remote echo, the 
terminal's local echo must be turned off (enter ECHO NO in 
Setup mode). 

PARITY 

The terminal's parity setting controls how the terminal sets 
the eighth bit (parity bit) in each character it sends to the 
host. The parity setting must match the kind of parity that 
the host expects. The SET PARITY command description 
lists and explains the possible settings. 

Descriptive name: SET PARITY 
Setup name: PARITY 



Pressing the terminal's Break key sends a break signal to 
the host. In full-duplex communications, the break sets the 
communication line in a "space" condition for the length of 
the break. This provides one way to interrupt host communi- 
cations when software conditions do not allow (for example, 
when the keyboard is locked). 

The factory default value for the break signal is 200 millisec- 
onds; this is adequate for most host computers. (Refer to 
your host's documentation to determine how the break 
signal is interpreted.) For hosts that do not accept break 
signals, set the break time to zero to disable the break 



Descriptive name: SET BREAK TIME 
Setup name: BREAKTIME 



STOP BITS 

While communicating with the host, the terminal sends and 
receives each character serially, as a sequence of ten or 
eleven bits. This is called asynchronous serial 6s\a commun- 
ications. The first bit for each character is a start bit, always 
a (or space) bit. The next seven bits determine the particu- 
lar ASCII character, after which comes a parity bit, as 
described earlier. The character ends with one or two stop 
bits, which are always 1 (or mark) bits. The communications 
line then remains in the marking condition until the start bit 
for the next character is detected. 

While transmitting characters to the host, the terminal 
includes one or two stop bits in each character it transmits. 
The terminal ignores the number of stop bits in characters 
coming from the host. 

Descriptive name: SET STOP BITS 
Setup name: STOPBITS 



BYPASS MODE AND THE BYPASS-CANCEL 
CHARACTER 

Sometimes you will want the terminal to ignore characters 
from the host. For example, when the terminal sends a 
report to the host, if the host echoes the report characters 
back to the terminal, the terminal could print them as alpha- 
text or interpret them as xy parameters, depending on the 
terminal mode. 

When the terminal is in Bypass mode it ignores all charac- 
ters from the host until it receives the bypass-cancel charac- 
ter. When the terminal receives this character, it leaves 
Bypass mode and discards the bypass-cancel character. 

If the bypass-cancel character is not a N u (Null character, 
ADE 0), the terminal automatically enters Bypass mode 
before it sends a report to the host. If the bypass-cancel 
character is set to the N u character, the terminal cannot 
enter Bypass mode. 

You can also place the terminal in Bypass mode with the 
ENTER BYPASS MODE command. For example, you might 
put the terminal in Bypass mode temporarily to suppress 
the echo of a user's password during a login procedure. 

You should set the bypass-cancel character to the last char- 
acter that the host echoes when the terminal sends a report. 
For example, if the host echoes c r l f when it receives a c r, 
set the bypass-cancel character to l f; if the host echoes 
only a c r, set the bypass-cancel character to c r. If the host 
does not echo at all, set the bypass-cancel character to N u. 
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COPING WITH d t FILLER CHARACTERS 

Some host computers intersperse d t (Delete or Rubout; 
ADE 127) characters among the characters they send to a 
terminal. The host inserts these filler characters and the 
applications program has no control over them. Since d t is a 
valid character in integer and xy-coordinate parameters, 
these extra d t characters can cause problems. 

The terminal includes two features that help solve this prob- 
lem. First, the terminal accepts the two-character sequence 

f_«» ., «_. D_ o„„^-.»j *u— i^nriDC nci rrco 

~cr cxs a ayiiunym lut " i. o6uunu, mc ivamvyni- l^i-i-i- i i_«j 

command causes the terminal to ignore any d t characters 
from the host. The terminal does not, however, ignore E c? 
sequences. 

Thus, if your host uses °t as a filler character: 

• Write driver routines to send ht7 in place of a °t charac- 
ter. Also change routines that issue integer and xy-coor- 
dinate parameters to output E c? instead of d t. 

• Send an IGNORE DELETES command followed by a 
SAVE NONVOLATILE PARAMETERS command. This 
sets the terminal to ignore °t characters: the setting will 
be remembered, even if the terminal is turned off. 



THE TERMINAL'S INPUT QUEUE 
AND HANDSHAKING PROTOCOLS 



There are several methods for preventing such data loss. 

Qottinn fhp nrr\r\ar hoi irl rotac ic imnnrtant■ thp ftPT TRAMQ. 

MIT RATE LIMIT command can slow down data transmis- 
sion for selected applications, as discussed earlier in this 
section. There are three other methods for more general 
control of data flow: 

• The terminal has an input queue to store data from the 
host until it can be processed. 

• There are two different handshaking schemes: 

• Flagging — prevents data overflow at the terminal 

• Prompt mode — prevents data overflow at the host 



THE INPUT QUEUE 

The terminal's input queue (or buffer) is a portion of terminal 
memory that acts as a "holding tank" for data waiting to be 
processed. Data from the host or a peripheral port is placed 
in the input queue; when the terminal is ready for that infor- 
mation it is removed from the queue and processed (com- 
mands are executed, graphics displayed, etc.). This frees 
memory that can then be used to store additional informa- 
tion in the queue. 

For example, the terminal cannot display characters while it 
is erasing the screen. Incoming characters are stored in the 
input queue until the erase operation is finished, and then 
the terminal reads the characters from the queue and proc- 
esses them. 



Often the terminal cannot process data immediately upon 
receiving it. For example, it takes longer to fill the inside of a 
polygon with a coior or fiii pattern than it does to receive and 
interpret the corresponding command from the host. Also, if 
the operator places the terminal in Local or Setup mode, no 
information from the host will be processed until the opera- 
tor cancels the mode. Likewise, there may be times when 
the host cannot process data as fast as the terminal sends 
it. Unless some provision is made for controlling communi- 
cations, data can be lost. 



While the terminal is in Setup mode, incoming characters 
are stored in the input queue. The terminal waits to process 
those characters until the operator terminates Setup mode. 

If the queue fills up, additional incoming data is simply dis- 
carded; no more data can be stored in the queue until some 
old data is removed. A very small queue may overflow fre- 
quently, causing important data to be lost. On the other 
hand, a large queue ties up valuable terminal memory that 
could be used to display graphics. The best queue size for 
each application will be determined by experience. 



Descriptive name: SET QUEUE SIZE 
Setup name: QUEUESIZE 
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THE NEED FOR HANDSHAKING 

The terminal can display simple alphanumeric text and 
graphics up to a maximum continuous data rate of 19200 
baud. At higher data rates, or for more complex operations, 
a handshaking protocol should be used to prevent the input 
queue from overflowing. Even at slow data rates, it may be 
wise to use a handshaking protocol. 



Flagging 

Flagging prevents the terminal's input queue from overflow- 
ing by allowing the terminal to start and stop data transmis- 
sions. Two types of flagging are available: DC1/DC3 
software flagging and DTR/CTS hardware flagging. The 
type of flagging you use must match the type used by the 
host. 



DC1/DC3 Flagging. DC1/DC3 flagging uses the DC3 and 
DC1 control characters ( D i and D 3, with ADEs 17 and 19, 
respectively) to inhibit or enable the transmitting device. 
DC3 is the stop character and DC1 is the start character. 
This allows you to use flagging with devices which do not 
have control of the RS-232-C DTR and CTS lines. Note that 
if a DC1 or DC3 character is garbled in transmission, the 
handshake with the host computer may cause communica- 
tion to stop. 

The terminal can be set to use DC1/DC3 flagging on input, 
output, or both input and output. 



DTR/CTS Flagging. In DTR/CTS flagging, the terminal 
indicates that it wants to transmit data by asserting RTS 
(Request To Send). If the host is ready to receive the data, it 
asserts CTS (Clear To Send). The terminal can transmit only 
when CTS is asserted. 



When receiving characters from the host, the terminal uses 
the DTR (Data Terminal Ready) signal line in the same way 
that the host uses the CTS line. If the host is sending char- 
acters faster than the terminal can process them, the termi- 
nal drops DTR. The host stops transmitting to the terminal. 
When the terminal is ready for more characters, it asserts 
DTR, and the host resumes its transmission to the terminal. 

NOTE 

DTR/CTS flagging is usually not practical when 
the terminal is connected to the host with a tele- 
phone line modem. In such circumstances you 
should use DC1/DC3 flagging because the host 
does not have direct access to the DTR and CTS 
signal lines. 

Descriptive name: SET FLA GGING MODE 
Setup name: FLAGGING 



Prompt Mode 

Prompt mode uses a character string called aprompt 
string, a waiting interval called a transmit delay, and the 
concept of a line of data to manage terminal-to-host trans- 
missions so that the host's input queue does not overflow. It 
works like this: 

1 . When the host is ready to receive data, it sends a 
prompt string to the terminal. 

2. When the terminal receives the prompt string, it waits 
for the transmit delay. During this time, the terminal 
does nothing. 

3. After the transmit delay has elapsed, the terminal 
sends one line of data to the host. 



If the terminal transmits characters faster than the host can 
process them, the host can drop CTS. When the host is 
ready to receive more characters, it asserts CTS and the 
terminal resumes transmission. 



4. Steps 1 , 2, and 3 are repeated until Prompt mode is 
terminated. 
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In Prompt mode, a line of data consists of all characters 
waiting to be transmitted up to and including the next EOM 
(end-of-message) character(s) (there can be one or two of 
them) or the next EOL (end-of-line) string. The EOL string is 
typically a c r (Carriage Return). 

Descriptive names: SET EOL STRING 

SET EOM CHARACTERS 
SET TRANSMIT DELAY 
SET PROMPT STRING 
PROMPTMODE 

Setup names: EOLSTRING 
EOMCHARS 
XMTDELAY 
PROMPTSTRING 
PROMPTMODE 



LINES OF TEXT AND THE TRANSMIT DELAY 

The preceding discussion mentioned the concepts of line 
and transmit delay. The following description explains these 
concepts in more detail. 

The Output Queue 

The terminal's output queue holds any characters that are 
waiting to be transmitted to the host. This includes any 
characters that have been typed on the keyboard (except in 
Setup or Local modes) and any report messages that have 
been requested by the host. 

The terminal sends characters in the output queue to the 
host one line at a time; that is, it sends characters from the 
output queue to the host until it reaches the end of a line. If 
there are no characters backed up in the queue, waiting to 
be sent, then each character is sent as soon as it is typed 
(even in Prompt mode). If the operator types faster than 
characters can be sent, then there will be some characters 
backed up in the queue. In either case, when the terminal 
encounters a c r it knows that the end of a line has been 
reached and waits until the transmit delay has elapsed 
before sending any more data to the host. (In Prompt mode, 
the terminal also waits to receive a prompt string from the 
host before sending the next line.) 



As discussed earlier, a line of text means "all the characters 
waiting to be transmitted, up to and including the next EOM 
character or EOL string." As the terminal is shipped from 
the factory, its only EOM character is c r, and the EOL string 
consists of one character, c r. Thus, if the terminal is set as it 
is when shipped from the factory then a line of text means 
"all characters waiting to be transmitted, up to and includ- 
ing the next c r character." 



REQUESTING REPORTS FROM THE 
TERMINAL 

An application program can find out various kinds of termi- 
nal status information by sending report commands. Each 
such command causes the terminal to send a particular 
report back to the host. The host's program must be written 

lu ii net yi ci 11 icsc rcpui La. rCi mia icciaun, tn6 oyi naX ui 

each report is explained in detail in the 4100-Style Parame- 
ter Types, Commands, and Reports section of this manual. 

The terminal ends each line in a report with an EOM charac- 
ter. (The terminal actually substitutes its current EOL string 
for each EOM character that is sent. The default EOL string 
is c r, although other characters may be selected with the 
SET EOL STRING command.) 



REPORT COMMANDS 

The following paragraphs list the report commands that you 
can send to the terminal and summarize what information 
the terminal can return for each command. See particular 
REPORT commands and REPORT message types for 
details. 

REPORT 4010 STATUS 

This command causes the terminal to send a 4010 status 
report. 

• If the terminal is not in GIN mode, the report includes a 
terminal status byte and the position of the alphanumeric 
(dialog area) cursor. 

• If the terminal is in GIN mode, the report includes the 
graphic cursor position. 



4107/4109 PROGRAMMERS 



2-5 



COMMUNICATIONS 



REPORT DEVICE STATUS 



REPORT SEGMENT STATUS 



This command causes the terminal to send a device status 
report for one of the terminal's communications ports: 

HO: the Host port 

PO: Peripheral Port 

P1 : Peripheral Port 1 

HC: the Color hardcopy interface 

REPORT ERRORS 

This command causes the terminal to generate an errors 
report message. This message reports the eight most 
recently detected error codes, their severity levels, and how 
many times each was detected. 

REPORT GIN POINT 

This command causes the terminal to generate one GIN 
report. This report is also sent when the operator causes a 
GIN event. The contents of this report depend on what GIN 
function-device code combination is currently enabled. 
Possibilities are: 

• Locator or Stroke report — returns the ASCII key 
pressed and the xy-location of the GIN cursor. 

• Pick report — returns the ASCII key pressed, the cursor 
position, and information about the segment picked. 

REPORT PORT STATUS 



This command allows the host to interrogate the terminal for 
information about one or more graphic segments. Possible 
information returned includes the segment's position, visi- 
bility, display priority, etc. 

REPORT SYNTAX MODE 

This command causes the terminal to report which syntax 
mode was selected by the most recent SELECT CODE 
command. 

REPORT TERMINAL SETTINGS 

This command aiiows the host to interrogate the terminal for 
various types of information: amount of free memory, termi- 
nal model number, firmware version number, and current 
parameter values for a specified command. 

Each time one of these reports is generated (except for the 
4010 Status Report), the terminal enters Bypass mode. In 
Bypass mode the terminal will not accept commands or any 
other input except the bypass-cancel character. The termi- 
nal remains in Bypass mode until it receives the bypass- 
cancel character or until the Cancel key is pressed. Refer to 
the 4100-Style Parameter Types, Commands, and Reports 
section of this manual for more information about the 
BYPASS CANCEL CHARACTER command, as well as the 
individual REPORT commands and messages. 



This command returns status information (baud rate, parity, 
flagging mode, etc.) for a specified peripheral port. 
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PORT COMMUNICATIONS 

The terminal's two-port peripheral interface allows it to 
communicate with several peripheral devices. Each device 
has its own communications protocol, and the terminal 
includes several commands to configure output to each 
port. The concepts for port communications are essentially 
the same as those for host communications. Following is a 
list of the commands that control port communications. 

SET PORT BAUD RATE 
Setup name: PBAUD 

Sets a single baud rate for all data transfer between the 

terminal and the specified port. 

SET PORT EOF STRING 
Setup name: PEOF 

Sets the end-of-file string for the specified port. 

SET PORT FLAGGING MODE 
Setup name: PFLAG 

Sets the flagging mode used for the specified port. 

SET PORT PARITY 
Setup name: PPARITY 

Sets the parity for input/output to the specified port. 

There are some differences between port parity modes 

and host parity modes. 



REPORT PORT STATUS 

Setup name: none 

Sends a status report of parameter settings for the speci- 
fied port. 

MAP INDEX TO PEN 

Setup name: PMAP 

Assigns color indices to pen numbers so that all colors 
with a given index are plotted with the same plotter pen. 

PORT ASSIGN 

Setup name: PASSIGN 

A rs c* ! r«i i»» r» i-» !■>*■» *t> i *"\ f\s\mvm n/sn+irtnp r"»rA\+/"\/"*^\l +*"i «"i i"i i s f j"* i"i r\/M*t 

rxooiyi 10 o. L/ctoio \j\ji mi i luiuauui ibpi uiuv/ui iu ayivcn j^wi i. 

A general purpose protocol allows you to transmit any 
RS-232 data. Other protocols allow graphics from the 
terminal to be interpreted by the various plotters sup- 
ported by the terminal. 

PLOT 

Setup name: PLOT 

Plots ail visible segments on a plotter attached to the 

specified port. 

COPY 

Setup name: COPY 

Copies information from the host to the specified port. 



SET PORT STOP BITS 
Setup name: PBITS 

Sets the number of stop bits in characters sent to the 

specified port. 
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THE GRAPHICS TERMINAL 



INTRODUCTION 



ABOUT THIS SECTION 

This section explains the graphics features of the terminal 
and introduces the terminal's commands in Tek mode. Read 
this section to learn how individual commands work 
together to control specific features. Once you have learned 
the general nature of the commands, refer to the section 
4100-Style Parameter Types, Commands, and Reports for 
details on each command. 

The principle topics in this section include: 

• Introduction. Information about this section, about the 
Tek mode command set, and about the terminal's 
display. 

• The Dialog Area. Displaying text in a dialog area in front 
of the graphics area. 

• Basic Graphics. Drawing lines, markers, panels, and text 
in the graphics area. 

• Segments. Storing pictures, or parts of pictures, for redis- 
play, and manipulating those stored picture 
segments. 

• Windows and Viewports. Zooming in on a stored picture 
to examine it in more detail, and displaying different 
pictures in different parts of the graphic area. 

• Surfaces. Splitting the graphics area into several writing 
surfaces, and assigning viewports to locations on these 
different surfaces. 

• Color Display. Selecting up to sixteen colors to use in the 
graphics area, and another eight colors to use in the 
dialog area. 

• Graphic Input. Using the joydisk or an accessory graph- 
ics tablet as a graphic input device. 

• Macros. Storing character strings in the terminal to be 
retrieved later for a variety of uses. 



• Defining Graphtext Characters. Designing your own 
stroke precision graphtext characters. 

• Pixel Operations. Writing directly into the terminal's 
raster memory pixel buffer. 

NOTE 

Examples of commands in this section are in a 
simplified format; an actual command uses either 
Setup or Host syntax, as shown in the detailed 
command description. This section gives just the 
command's descriptive name followed by a : and 
the example values for the command's parameters. 



ABOUT THE TEK MODE COMMAND SET 

The commands described in this section all belong to the 
Tektronix 4100 Series terminal command set and operate 
from the host only in Tek mode. Tek mode commands are 
also referred to as 4100-style commands; this term includes 
both the Host version and the Setup version of Tek mode 
commands. 



NOTE 

Before issuing any Tek mode (4100-style) com- 
mands from the host computer, be sure that the 
terminal is set to Tek mode with the SELECT 
CODE command. 



To put the terminal in Tek mode, have the host computer 
send a SELECT CODE command that specifies Tek mode. 
The complete set of graphics commands is now available to 
the host. 

An operator can use the graphics commands at any time, 
regardless of whether the terminal is in Tek mode. To do so, 
the operator puts the terminal in Setup mode and types the 
Setup versions of these commands. 
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ABOUT THE DISPLAY 

The terminal displays two types of information: 

• Host/operator dialog 

• Graphics 

The host/operator dialog consists of messages from the 
host and the operator's responses. Graphics is the screen's 
pictorial information. Usually, a host program directs the two 
types of information to separate areas of the screen. The 
area of the screen where the host/operator dialog appears 
is the dialog area. The area where graphics is displayed is 
the graphics area. Figure 3-1 shows the idea. 



THE DIALOG AREA 

Think of the dialog area as a writing surface that sits in front 
of the graphics area. The dialog area can vary in size from 
two lines (at the bottom of the screen) to 32 lines (occupying 
the entire screen). As explained later in "Colors and Trans- 
parency," the dialog area need not completely cover the 
graphics area, and you can make the dialog area transparent. 

Either a host program or the operator can set the size of the 
dialog area by specifying the number of dialog lines. The 
operator uses the DALINES command; a host program uses 
the SET DIALOG AREA LINES command. 

NOTE 

Dialog area features that you set while the terminal 
is in Ansi mode remain in effect when the terminal 
enters Tek mode. 



DIALOG BUFFER 

The terminal can save more lines of dialog than what the 
dialog area shows. The saved lines, which include the lines 
displayed, are the dialog buffer. A host program sets the 
number of lines saved with the SET DIALOG AREA 
BUFFER SIZE command; the operator uses the Setup 
command DABUFFER. The operator or the host computer 
can scroll the lines of the dialog buffer, moving different 
parts of the buffer into view (see Figure 3-1). As more lines 
of dialog accumulate, the dialog buffer fills up, and the 
terminal discards the oldest line for every new line saved. 

ALPHATEXT 

Alphatext is the type of text the terminal uses to display 
messages from the host. (The other type of text, graphtext, 
is used as labels in pictures. It is described under "Basic 
Graphics," later in this section.) 

Alphatext consists of the ordinary characters that the host 
sends to the terminal and expects the terminal to display as 
alphanumeric characters. Characters that are part of com- 
mands or graphic coordinates to the terminal are not 
alphatext. 

When the terminal is in Tek mode, it displays alphatext on 
the screen. (In this state the terminal is said to be in Alpha 
mode.) While the dialog area is disabled, alphatext is dis- 
played in the graphics area. It may appear on the screen in 
one of two sizes, depending on the SET 4014 ALPHATEXT 
SIZE command. 

When the dialog area is enabled and visible, or the terminal 
is in Ansi or VT52 mode, the terminal displays alphatext in 
the dialog area. 
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Figure 3-1 . Dialog and Graphics Areas. 
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ENABLING THE DIALOG AREA 

When the dialog area is enabled, all alphatext is sent to the 
dialog buffer but not necessarily displayed. A host program 
enables or disables the dialog area with the ENABLE DIA- 
LOG AREA command; the operator uses the Setup com- 
mand DAENABLE. 

When the dialog area is disabled, the terminal emulates a 
Tektronix 4010 Series terminal. (Such terminals do not have 
a dialog area.) With the dialog area disabled, alphatext 
appears in the graphics area at locations determined by 
previous commands or display operations. 

MAKING THE DIALOG AREA VISIBLE 

The dialog area does not appear on the screen unless it is 

tdtuie. ii lu© uioiw^ aioci 10 ci icti/icu, li ic uidiw^ to aaVcu 11 1 

the dialog buffer; but dialog is not displayed unless the 
dialog area is both enabled and visible. If the dialog area is 
enabled but invisible, changing the the dialog area to visible 
displays dialog that accumulated while the dialog area was 
Invisible. A host program sets dialog visibility with SET 
DIALOG AREA VISIBILITY; the operator uses the Setup 
command DAVISIBILITY. 



COLORS AND TRANSPARENCY 

The SET DIALOG AREA INDEX command (Setup com- 
mand DAINDEX) sets these colors in the dialog area: 

• Character color — the color for alphatext in the dialog 
area 

A /^l^««-rtr%trNr t-»Q 1 r%U*-i>-^\i ••"»/■< f l-t« *-«<-» l<-ir /-\f tho /-<oll <?i trrrw inrl- 

» \-/i icii avi^i k/av/nui uunu li ic \*\ji\j\ \j\ ikc uCii «jui iuui iO~ 

ing each character 

• Dialog background — the color of the dialog area before 
anything is written on it 

Figure 3-2 shows where the dialog area uses these colors. 

Both the dialog background and character background can 
be transparent. Graphics behind a transparent area can be 
seen. For example, when character background is transpar- 
ent, alphatext appears as if it were written on a piece of 
glass in front of the graphics. 

The details of specifying colors are explained later in this 
section. 



DIALOG AREA COMMANDS 

Table 3-1 lists the commands that control the dialog area. 
Most of these commands can either be sent by the host or 
be entered by the operator as a Setup command. The SAVE 
NOVOLATILE PARAMETERS command (Setup mode 
NVSAVE command) saves the settings made by these com- 
mands; these settings are then retained even when the 
terminal is turned off. 



Table 3-1 
COMMANDS AFFECTING THE DIALOG AREA 



Host Command 


Setup 
Command 


Function 


ENABLE 
uiml-Uo Ancrt 


DAENABLE 


Directs alphatext either to the 
dialog area or graphics area 


SET DIALOG AREA 
BUFFER SIZE 


DABUFFER 


Sets the maximum number of 
dialog lines the terminal 
remembers 


SET DIALOG 
AREA LINES 


DALINES 


Sets the maximum number of 
dialog lines visible at one time 


SET DIALOG 
AREA INDEX 


DAINDEX 


Sets color index of dialog text 
and background 


SET DIALOG 
AREA COLOR MAP 


DACMAP 


Defines the colors of the eight 
dialog area color indices 


SET DIALOG AREA 
WRITING MODE 


DAMODE 


Sets space and underscore 
either to replace or to 
overstrike other characters 


SET DIALOG 
AREA VISIBILITY 


DAVISIBILITY 


Makes dialog area visible or 
invisible 


CLEAR DIALOG 
SCROLL 


CLEAR- 
DIALOG or 
D Eras key 


Deletes all characters in the 
dialog buffer 



CHARACTER 
COLOR 

ABC 



dialog 
background 



CHARACTER 
BACKGF UNO 



Figure 3-2. Colors in the Dialog Area. 
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BASIC GRAPHICS 

This discussion tells how a program can draw pictures in 
the graphics area. Subjects covered are: 

• Terminal Space. How to specify screen positions. 

• Lines. How to draw lines, and how to make them solid, 
dashed, or colored. 

• Markers. How to mark screen positions with small 
symbols. 

• Panels. How to fill an area with a pattern or color. 

• Graphtext. How to put text in your pictures. 



TERMINAL SPACE 

Graphics are created on a conceptual two-dimensional 
surface called terminal space. All or part of terminal space 
might be displayed in the graphics area depending on the 
window you display. (Windows are described later in this 
section.) 

Commands use terminal space coordinates to specify loca- 
tions in terminal space. These are rectangular cartesian 
coordinates, and when sent to the terminal must be coded a 
certain way. (See "XY-Coordinates in Host Syntax" in the 
section 4100-Style Parameter Types, Commands, and 
Reports for instructions.) 

Figure 3-3 shows the positions certain coordinate pairs 
indicate. In the figure, the shaded area represents a dis- 
played portion of terminal space. This displayed area (win- 
dow) can be changed with the SET WINDOW command, 
described later in this section. 

You can use any integer from through 4095 for either the 
x- or the y-coordinate. This range covers the entire terminal 
space. Each unit in this coordinate system is a terminal 
space unit (TSU). 



Current Position 

There is always one position in terminal space that is the 
graphics beam position, often called just the current posi- 
tion. This is the position that was specified in the last graph- 
ics display operation and is usually the default position the 
terminal uses when none is specified. When the terminal is 
first turned on, position (0,3071) is the current position. This 
position is called the Home position and is near the upper 
left comer of the screen when the factory default window is 
used. (Windows are described later in this section.) 



(0,4095) 



(4095,4095) 

• 



(0,3071) 
HOME 



(2000,2000) 



(1000,1000) 



(4095,3132) 



(0,0) 



(4095,0) 



Grey area shows factory default window. 



Figure 3-3. Terminal Space Coordinates. 
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LINES 

To draw iines, you can use either of two methods. One 
method uses a special mode, Vector mode, in which the 
terminal interprets messages from the host as encoded 
positions for line segment endpoints. The other method 
uses MOVE and DRAW commands. Figure 3-4 shows the 
two methods. 



Vector Mode 



Vector mode. When in this mode, the terminal interprets all 
characters the host sends, except for characters forming 
commands, as xy-coordinates. (See the section 4100-StyIe 
Parameter Types, Commands, and Reports for instructions 
on sending xy-coordinates.) 



The first xy-coordinate pair specifies where the line starts. 
When the terminal receives a second coordinate pair, it 
draws a line to that position and makes it the current posi- 
tion. As the terminal receives subsequent coordinates, it 
repeats the process, drawing a line from the current position 
to the specified position, and updating the current position. 
This continues until the terminal leaves Vector mode. 

At times, you might want to start a line at a new position 
without drawing a line to that position. (This is like lifting the 
pen from the paper in a drawing and moving it to a new 
location.) To do this, send another ENTER VECTOR MODE 
command. A new line starts at the next position you specify. 

At times, you might want to draw a line from the current 
position when the terminal is not yet in Vector mode. To do 
this, issue an ENTER VECTOR MODE command followed 
by the b l character. The terminal chimes and draws a line 
from the current position to the next position you specify. 















f > 
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MOVE and DRAW Method 




Vector M 
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Command Description After Encoding 


Command Description 


After Encoding 




MOVE 1000,1000 E cLF'*z'Z 


ENTER VECTOR MODE 


G s 




DRAW 1500,1500 E cLG+^w+W 


1000,1000 


' 'z'Z 




DRAW 2000,1000 E cLG' X z/T 


1500,1500 


+ 'w+W 




DRAW 2500,1500 E cLG+^w3Q 


2000,1000 


' V z/T 






2500,1500 


+ "v»3Q 






ENTER ALPHA MODE 


u s 








4526-6A 



Figure 3-4, Two Methods for Displaying a Line. 
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MOVEs and DRAWs 



MARKERS 



The MOVE-and-DRAW method of creating lines uses indi- 
vidual commands to create lines. The terminal does not 
need to be in Vector mode to execute these commands. 

The MOVE command sets the current position, but does not 
draw a line to that position. The command's effect is analo- 
gous to lifting a pen from paper and placing it at a new posi- 
tion in a drawing. 

The DRAW command draws a line from the current position 
to the position specified in the DRAW command. The cur- 
rent position is then changed to the position specified in the 
command. 



Attributes of Lines 

Before drawing a line on the screen, you can set both a line 
style and a line index for the line. The seven available line 
styles are shown with the detailed description of the SET 
LINE STYLE command. The line index determines the 
line's color. With the SET LINE INDEX command you can 
assign any of the available color indices to the line before 
drawing it. (Color indices are explained later in this section.) 



A marker is a small, predefined symbol that marks a posi- 
tion in terminal space. Before displaying a marker, you can 
choose any of eleven marker types shown in the description 
of the SET MARKER TYPE command. You then use either 
of two methods to display markers: one method uses 
Marker mode; the other method uses an individual com- 
mand, MARKER, to create each marker. 



Marker Mode 

The ENTER MARKER MODE command puts the terminal in 
Marker mode. The terminal then interprets all characters it 
receives, except for those in commands, as xy-coordinates. 
It places a marker at each specified position. 

The only way to leave Marker mode is to issue the ENTER 
ALPHA MODE command. Alpha mode is the only mode you 
can enter directly from Marker mode. 



DRAW MARKER Command 

The DRAW MARKER command specifies a single position. 
(In Setup mode, the command name is MARKER.) The 
terminal displays, at the specified position, the type of 
marker selected in the most recent SET MARKER TYPE 
command. The terminal does not have to be in Marker 
mode when it executes the DRAW MARKER command. 
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PANELS 

A panei is an area in terminai space that can be fiiieci with 
any of 156 predefined patterns. Figure 3-5 gives some 
examples of panels. 

These steps describe how to create a panel. 

1 . Send the SELECT FILL PATTERN command and spec- 
ify the fill pattern you want to use. For the available 
choices, see the detailed description of this command. 



specifies the starting position of the panel's boundary 
line and whether that boundary line should be dis- 
played in the finished panel. 

Define the panel's boundary line. Do this in either of 
two ways: 

a. Put the terminal in Vector or Marker mode and then 
send the coordinates of boundary segment end- 
points. 

b. Send MOVE and DRAW commands. 

It is not necessary to define the last segment which 
closes the panel. 



4. Send the END PANEL command. This automatically 
creates a boundary line segment back to the starting 
position and displays the panel with its fill pattern. The 
current position is set to the panel's starting position. 

If the terminal is in Marker mode during this process, mark- 
ers are not displayed. 

If the terminal is in Vector mode, the boundary line is dis- 
played as the panel is created. Depending on the choice 
specified in the BEGIN PANEL BOUNDARY command, the 
boundary line is either displayed in the finished panel or 

f*/"^\/esrtiH H\/ +Kq fill nottarn 

If a panel's boundary crosses itself as in Figure 3-5C, the 
terminal uses this rule to determine which areas are inside 
the panel: If, starting from a point distant from the panel, 
you cross the boundary an odd number of times to get to the 
area, the area is in the panel; if you cross the boundary an 
even number of times, the area is outside the panel. Only 
areas inside the panei are filled. 

As shown in Figure 3-5B, a panel can have more than one 
boundary. To make such a panel, issue additional BEGIN 
PANEL BOUNDARY commands before ending the panel. 
When you issue an additional BEGIN PANEL BOUNDARY 
command, this closes the boundary being created and 
starts a new boundary at the specified position. The pane! is 
not filled until the terminal receives the END PANEL 
command. 



A. Panel With 
One Boundary 



Panel With 
Two Boundaries 



C. Panel Whose 

Boundary Crosses Itself 





Figure 3-5. Examples of Panels. 
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GRAPHTEXT 

Graphtext is a special type of text for use in the graphics 
area. You should always use graphtext in the graphics area 
because of its versatility and because it leaves the dialog 
area undisturbed. Graphtext can be resized, rotated, and 
written in different directions. The terminal lets you put 
alphatext in the graphics area, but this feature is provided 
primarily for compatibility with TEKTRONIX 401 0-Series 
terminals. 

Before you send the GRAPHIC TEXT command, the com- 
mand that displays graphtext, you can set several attributes 
of graphtext with other commands. See Figure 3-6 for a list 
of these commands and examples. 

Only printable characters can be in the string you specify as 
graphtext. This includes the ASCII characters s p through - 
(ASCII decimal equivalents 32 through 1 26). The terminal 
detects an error for characters outside this range. 



String Precision and Stroke Precision 

One of the graphtext attributes is the graphtext precision, 
which you set with the SET GRAPHTEXT PRECISION 
command. This command selects either string precision or 
stroke precision. Stroke precision graphtext is more versa- 
tile than string precision graphtext; for example, stroke 
precision graphtext can be displayed at rotation angles 
other than 90°. 

As shown in Figure 3-6, stroke precision graphtext differs 
from string precision in several ways: 

• String precision graphtext characters can only be rotated 
in multiples of 90°. For instance, if SET GRAPHTEXT 
ROTATION specifies an angle of 30°, individual string 
precision characters remain upright, although the string 
as a whole will tilt upwards at a 30° angle. Stroke preci- 
sion characters, however, are each individually rotated at 
the specified 30° angle. 



• When string precision characters are enlarged with the 
SET GRAPHTEXT SIZE command (or by "zooming in" 
on a view), they can only be displayed in sizes which are 
integral multiples of the basic dot matrix character size. 
In the SET GRAPHTEXT SIZE command, string preci- 
sion graphtext uses only the height parameter; the width 
and gap parameters are ignored. 

• By contrast, stroke precision text can be displayed with 
any height, width, or inter-character gap. However, the 
line segments with which stroke precision characters are 
drawn do not get any thicker when you make the charac- 
ters larger. 

• The SET GRAPHTEXT SLANT command only works on 
stroke precision graphtext. 

• Different commands are used to switch between charac- 
ter sets for string precision graphtext and stroke preci- 
sion graphtext. 

String precision graphtext is always displayed with the 
same character set as is used for alphatext. First, a charac- 
ter set is designated as GO or G1 with the Ansi mode SCS 
(Select Character Set) command. Then, the current GO or 
G1 set is invoked with the Ansi mode s i (Shift In) or s o (Shift 
Out) control characters, or with the Tek mode command, 
SET ALPHATEXT FONT. 

Stroke precision graphtext, however, is displayed with the 
character set chosen by the most recent SET GRAPHTEXT 
FONT command. 

• You can design your own stroke precision fonts, as 
described later in this section. This is not possible for 
string precision graphtext. 
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Command 



Effect on String 
Precision Graphtext 



Effect on Stroke 
Precision Graphtext 



SET 

GRAPHTEXT 

ROTATION 



ABC 



flBC 



u 


o 


CO 


m 


^x 


<z 



ABC 



30° 45° 90° 0° 

Character path is RIGHT in all examples. 



X 


X 


Lii 
X 


30° 


45° 


90° 



SET 

CHARACTER 

PATH 



ABC 



RIGHT 



C 

B 
PI 

X 
UP 



CBA„ 

LEFT 



X 

A 

B 

C 



A B C 



DOWN RIGHT 

Rotation = 0° in ail examples. 



P 

A 

X 

UP 



C BfC 



LEFT 



H 
b 
C 

DOWN 



SET 

GRAPHTEXT 

SIZE 




HEIGHT 



(Width and gap parameters are ignored.) 



<1 1 I {height 



WIDTH 



GAP 
Path = RIGHT 



I P HEIGHT 






IISMMP^I 



.GAP 



WIDTH 
Path = DOWN 



SET 

GRAPHTEXT 

SLANT 



No effect on string precision graphtext. 



flee 



Slant angle =10° 



Figure 3-6. Commands to Set Graphtext Characteristics. 
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ALPHATEXT IN GRAPHICS 



DEFINING A SEGMENT 



As mentioned before, alphatext should not be used for 
labels in pictures. Use graphtext instead. 

Alphatext can be used in pictures, provided the dialog area 
is disabled. But this feature is provided only for compatibility 
with earlier terminals that did not have graphtext. Alphatext 
cannot be rotated or slanted. The two alphatext sizes (SET 
4014 ALPHATEXT SIZE command) have unchangable 
dimensions. Alphatext does not change size during zoom- 
ing operations. Consequently, you can't use variable win- 
dows, or the terminal's Zoom and Pan keys, to view 
alphatext in more detail. 



SEGMENTS 



INTRODUCTION 

A segment (short for "graphic display list segment") is a 
graphic object that is defined (saved) in the terminal's inter- 
nal memory and given a name, or segment number. Once 
you have defined part of a picture as a segment, you can 
then make it invisible, make it visible again, move it from 
one part of the screen to another, change its size and orien- 
tation angle, and even include it in the definition of another 
segment. 

In order to use some of the terminal's other features, it is 
necessary first to define graphic information in a segment. 
For example: 

• To let the operator "zoom in" on a picture with the view- 
ing keys, you must first store the picture in the terminal's 
memory as one or more segments. 

• In order to replace the crosshair GIN cursor with a cursor 
of your own design, the cursor you design must be 
defined as a segment. 

• In order to make a graphic object blink on or off, that 
object must be defined as a segment. 



To define a segment, do the following: 

1 . Send a SET PIVOT POINT command. This specifies a 
point to be used as a reference point for the entire 
segment. For instance, when you move a segment to a 
particular location, the terminal moves the whole seg- 
ment so that the pivot point is at the location specified. 
When you rotate the segment, it rotates about its pivot 
point. 

2. Send a BEGIN SEGMENT command. This starts the 
segment definition, and specifies the segment number 
(the segment's name). The segment's pivot point is the 
pivot point specified in the most recent SET PIVOT 
POINT command. 

3. Draw a graphic object. Use any of the commands 
described under "Basic Graphics," earlier in this 
section. 

4. End the segment definition with an END SEGMENT 
command. 

Besides BEGIN SEGMENT and END SEGMENT, you can 
use some other, shorter, commands: 

• BEGIN NEW SEGMENT is a combination of END SEG- 
MENT and BEGIN SEGMENT; it ends the segment cur- 
rently being defined and starts the definition of a new 
segment with a specified segment number. The pivot 
point of the new segment is at the current graphics beam 
position. 

• BEGIN HIGHER SEGMENT is similar, but you need not 
specify the segment number; it is one greater than the 
segment number of the previous segment. 

• Likewise, BEGIN LOWER SEGMENT terminates a seg- 
ment definition and begins another segment with the 
next lower segment number. 



NOTE 

The commands BEGIN NEW SEGMENT, 
BEGIN HIGHER SEGMENT, and BEGIN 
LOWER SEGMENT all create segments whose 
pivot points are at the current graphics beam posi- 
tion. Use these commands for segments that will 
remain in the same position. Use the BEGIN SEG- 
MENT command for defining segments that you 
will move, scale, or rotate with the SET SEG- 
MENT POSITION or SET SEGMENT IMAGE 
TRANSFORM commands. 
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MOVING SEGMENTS AROUND 

Once you have defined a segment, you can change its size 
(stretch it in the x- and y-directions), rotate it about its pivot 
point, and move it to another location in terminal space. The 
command for this is SET SEGMENT IMAGE TRANSFORM 
(see the command's detailed description). 

If you only want to change a segment's position, and not its 
size or rotation angle, you can use the SET SEGMENT 
POSITION command, instead. 



USING ONE SEGMENT IN THE DEFINITION OF 
ANOTHER 

While defining one segment, you can change the position of 
another segment and then send INCLUDE COPY OF SEG- 
MENT to include a copy of that segment in the segment you 
are defining. You can do this repeatedly. For instance, you 
might draw an apple tree as follows: 

1 . Delete any Segment 1 or Segment 2 that may currently 
exist: 

a. DELETE SEGMENT: 1 

b. DELETE SEGMENT: 2 

2. Define Segment 1 to represent an apple: 

a. Issue SET PIVOT POINT for a point which will be 
the center of an apple. 

b. BEGIN SEGMENT: 1 

c. Draw a panel representing a red apple. Draw the 
panel boundary so as to include the pivot point 
inside it. (Use SELECT FILL PATTERN to choose a 
red color for the apple, and then BEGIN PANEL 
boundary, MOVEs and DRAWs, and END PANEL 
to draw the apple.) 

d. END SEGMENT 



3. Define Segment 2 to represent the apple tree: 

a. BEGIN SEGMENT: 2 

b. Draw a panel representing the green branches of 
the tree. 

c. Draw a panel representing the brown trunk of the 
tree. 

d . Move segment one to a location among the 
branches of the tree. (Issue a SET SEGMENT 
POSITION command for segment 1 .) 

e. INCLUDE COPY OF SEGMENT: 1 

f. Repeat steps 3d and 3e several times to place 
apples at different places in the branches. 

g. END SEGMENT 

GRAPHICS PRIMITIVES WITHIN SEGMENTS 

When you define a segment, you draw it using a number of 
graphics primitives, such as MOVE, DRAW, panels, and 
graphtext. You can vary the attributes (dashed line style, 
line color, text color, fill pattern for panels) of these primitives. 

However, once the segment is defined, you cannot change 
the primitives or primitive attributes. The only way to edit a 
segment is to delete it (with the DELETE SEGMENT com- 
mand) and define it again. 

One special graphic primitive is the pick identification num- 
ber. This is used only during graphic input pick operations; 
it has no effect on the segment's appearance. However, if a 
segment is to be "picked" in a graphic input operation, and 
different parts of the segment are to have different pick i.d. 
numbers, then you must issue the SET PICK ID command 
from time to time while defining the segment. For more 
information, see the SET PICK ID command's detailed 
description. 
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ATTRIBUTES OF SEGMENTS 

Segments have one fixed attribute and a variety of change- 
able attributes. The fixed attribute is the pivot point, which 
cannot be changed after beginning the definition of a 
segment. 



Changeable segment attributes are listed along with other 
segment commands in Table 3-2. For more information, see 
the descriptions of the individual commands in the section 
4 100-Style Parameter Types, Commands, and Reports. 



Table 3-2 
COMMANDS PERTAINING TO SEGMENTS 



Descriptive Name 


Setup Mode Command 


Function 


SET PiVOT POiNT 


SGPiVOT 


Sets the pivot point tor new segments not yet defined. 


BEGIN SEGMENT 


SGBEGIN 


Begins a segment definition. 


END SEGMENT 


SGEND 


Ends a segment definition. 


BEGIN NEW SEGMENT 


SGNEW 


Ends one segment definition and starts another. 


BEGIN HIGHER SEGMENT 


SGHIGHER 


Ends one segment definition and starts another with the next higher 
segment number. 


BEGIN LOWER SEGMENT 


SGLOWER 


Ends one segment definition and starts another with the next lower 
segment number. 


INCLUDE COPY OF SEGMENT 


SGCOPY 


Puts copy of defined segment into segment being defined. 


SET PICK ID 


SGPICKID 


While defining a segment, marks part of it with a pick identification 
number 'for later use when picking the segment during a graphic 
input operation. 


DELETE SEGMENT 


SGDELETE 


Deletes a defined segment. 


RENAME SEGMENT 


SGRENAME 


Changes a segment's name (segment number). 


SET SEGMENT POSITION 


SGPOSITION 


Moves a segment so that its pivot point is at a specified location. 


SET SEGMENT IMAGE TRANSFORM 


SGIMAGETRANSFORM 


Scales the segment in the x- and y-directions, rotates it about its 
pivot point, and then moves it to a specified position. 


SET SEGMENT VISIBILITY 


SGVISIBILITY 


Makes a segment visible or invisible. 


SET SEGMENT HIGHLIGHTING 


SGHIGHLIGHTING 


Causes a segment to blink on and off: to alternately be visible and 
invisible. 


SET SEGMENT WRITING MODE 


SGWRITINGMODE 


Chooses whether a segment is to be drawn in Set mode or XOR 
mode. 


SET SEGMENT DISPLAY PRIORITY 


SGPRIORITY 


Sets the priority order (front to back order) for displaying (and 
picking) segments which overlap. 


SET SEGMENT DETECTABILITY 


SGDETECTABILITY 


Specifies whether a segment can be picked with the pick graphic 
input function. 


SET SEGMENT CLASS 


SGCLASS 


Adds a segment to one set of segment classes and deletes it from 
another set of segment classes. 


SET CURRENT MATCHING CLASS 


SGMATCHINGCLASS 


Specifies the segment matching class in terms of already-defined 
segment classes. 
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Table 3-2 
COMMANDS PERTAINING TO SEGMENTS 



Descriptive Name 


Setup Mode Command 


Function 


SET PIVOT POINT 


SGPIVOT 


Sets the pivot point for new segments not yet defined. 


BEGIN SEGMENT 


S GO PEN 


Begins a segment definition. 


END SEGMENT 


SGCLOSE 


Ends a segment definition. 


BEGIN NEW SEGMENT 


SGNEW 


Ends one segment definition and starts another. 


BEGIN HIGHER SEGMENT 


SGUP 


Ends one segment definition and starts another with the next higher 
segment number. 


BEGIN LOWER SEGMENT 


SGDOWN 


Ends one segment definition and starts another with the next lower 
segment number. 


INCLUDE COPY OF SEGMENT 


SGINCLUDE 


Puts copy of defined segment into segment being defined. 


SET PICK ID 


SGPICKID 


While defining a segment, marks part of it with a pick identification 
number lot later use when picking the segment during a graphic 
input operation. 


DELETE SEGMENT 


SGDELETE 


Deletes a defined segment. 


RENAME SEGMENT 


SGRENAME 


Changes a segment's name (segment number). 


SET SEGMENT POSITION 


SGPOSITION i Moves a segment so that its pivot point is at a specified location. 


SET SEGMENT IMAGE TRANSFORM ! SGTRANSFORM | Scales the segment in the x- and y-directions, rotates it about its 

| j pivot point, and then moves it to a specified position. 



SET SEGMENT VISIBILITY 


SGVISIBILITY 


Makes a segment visible or invisible. 


SET SEGMENT HIGHLIGHTING 


SGHIGHLIGHTING j Causes a segment to blink on and off: to alternately be visible and 

1 invisible. 


SET SEGMENT WRITING MODE 


SGMODE j Chooses whether a segment is to be drawn in Set mode or XOR 

mode. 


SET SEGMENT DISPLAY PRIORITY 


SGPRIORITY 


Sets the priority order (front to back order) for displaying (and 
picking) segments which overlap. 


SET SEGMENT DETECTABILITY 


SGDETECT 


Specifies whether a segment can be picked with the pick graphic 
input function. 


SET SEGMENT CLASS 


SGCLASS 


Adds a segment to one set of segment classes and deletes it from 
another set of segment classes. 


SET CURRENT MATCHING CLASS 


SGMATCHINGCLASS 


Specifies the segment matching class in terms of already-defined 
segment classes. 
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SPECIAL SEGMENT NUMBERS 



SEGMENT CLASSES 



Each individual segment that you define has a number in 
the range from 1 to 32767. Besides these positive segment 
numbers, however, there are certain other special segment 
numbers, as follows: 

• Segment 0. Segment refers to the crosshair graphics 
cursor. For instance, you can issue a SET SEGMENT 
POSITION command for Segment 0, and thereby move 
the crosshair cursor. If a command cannot be used with 
the crosshair cursor, then specifying Segment causes 
the terminal to detect an error. For instance, you cannot 
rotate the crosshair cursor, so the SET SEGMENT 
IMAGE TRANSFORM command does not accept as a 
valid segment number. 

• Segment -1 . Segment -1 means "all positive-numbered 
segments." By specifying -1 in a command to set a 
segment attribute, you can set that attribute for all the 
currently defined segments. For instance, you can issue 
a SET SEGMENT VISIBILITY command for Segment -1 
to make all segments invisible, or to make all segments 
visible again. 

• Segment -2. Segment -2 means "default for new seg- 
ments not yet defined." When you issue a command to 
set a segment attribute for Segment -2, you cause all 
future segments that you later define to assume the 
specified attribute. For instance, you can issue a SET 
SEGMENT VISIBILITY command for Segment -2, and 
thereby cause all future segments to be visible (or invisi- 
ble). 

• Segment -3. Segment -3 means "all segments in the 
current segment matching class." When you issue a 
command to set a segment attribute for Segment -3, you 
cause all segments in the segment matching class to 
assume the specified attribute. (The segment matching 
class is described under "Segment Classes," the next 
topic in this section.) 



NOTE 

The following description gets rather mathemati- 
cal. On a first reading, you may want to skip this 
part and proceed to "Windows and Viewports," the 
next major topic in this section. 



Introduction 

A segment class is a collection of segments. In mathematical 
terms, it would be called a set of segments. By means of 
segment classes, and in particular, the segment matching 
class, you can manipulate whole groups of segments 
together. You can cause whole groups of segments to blink, 
to change position, or to become visible or invisible. 
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SET SEGMENT CLASS Command 



Set Notation 



You place segments in segment classes, or remove them 
from segment classes, with the SET SEGMENT CLASS 
command. (The Setup mode name for this command is 
SGCLASS.) This command has three parameters: 

• The first parameter specifies a particular segment which 
is to be added to, or removed from, one or more segment 
classes. 

• The second parameter is a list of class numbers specify- 
ing classes from which the specified segment is to be 
removed. The host sends this parameter as an array of 
integers. In setup mode, the operator types a left angle 
bracket, then several class numbers, and then a right 

Uii^lO wiQuiVbi, 

• The third parameter is a list of class numbers specifying 
classes to which the specified segment is to be added. It 
is specified in the same way as the second parameter. 

For instance, while becoming acquainted with segment 
classes, you might try typing the following command in 
Setup mode: 

SGCLASS2<1 2 3> <4 5 6> 

This would first remove Segment 2 from Segment classes 1 , 
2, and 3, and then add Segment 2 to classes 4, 5, and 6. 

For the first parameter, you can use the special segment 
numbers just described. Also, in the second and third 
parameters, you can use "-1 " to mean "all segment 
classes." For instance, 

SGCLASS-2<-1> <1 2 3> 

causes "segments not yet defined" (Segment -2) to be 
removed from "all segment classes" (class -1), and then 
added to segment classes 1 , 2, and 3. Any segments that 
you subsequently define would then belong to segment 
classes 1 , 2, and 3, and to no other segment classes. 



NOTE 

In the following text, the D symbol represents the 
set intersection operator, the U symbol represents 
the set union operator, and the overline symbol 
represents the set complement operator. Thus, 

(class 1) fl (class 2) 

means the intersection of segment classes 1 and 2, 
that is, the set of all segments which are in segment 
class 1 and also in segment class 2. Again, 

(class 1) U (class 2) 

istnrtrt-yic thin itvnfwt f\ T r/imn/in -t /-'frtccsic' 1 rtvtrl r i-yirti- ir 

the set of all segments which are either in segment 
class 1, or in segment class 2, or both. Finally, 



(class 1) 

means the complement of segment class I, that is, 
the set of all segments which are not in segment 
class 1. 



The Segment Matching Class 

The segment matching class is a set of segments that is 
defined in terms of other segment classes. To define the 
segment matching class, issue a SET SEGMENT MATCH- 
ING CLASS command. (In Setup mode, this is SGMAT- 
CHINGCLASS.) This command has two parameters: 

• The first parameter is a list of class numbers for classes 
to which segments in the matching class must belong. 

• The second parameter is a list of class numbers for 
classes to which segments in the matching class must 
NOT belong. 
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For instance, suppose you want the segment matching 
class to include all segments that are in class 1 and also in 
class 2, but not in class 3. That is, you want the segment 
matching class to be the set intersection of class 1 and 
class 2 with the complement of class 3: 

(segment matching class) = (class 1) 
n (class 2) n (class 3) 

To accomplish that, you could type the following Setup 
mode command: 

SGMATCHINGCLASS<1 2> <3> 

This sets the segment matching class to the set of seg- 
ments which is the intersection of segment class 1 with 
segment class 2 and with the complement of segment 
class 3. 



Using the Segment Matching Class 

Once you have placed segments in various classes, and 
defined the segment matching class in terms of those 
classes, you can use the special segment number, -3, to 
mean "all segments in the current matching class." 

For instance, if you want to highlight all segments that are in 
class 1 and class 2, but not in class 3, you could proceed as 
follows: 

SGMATCHINGCLASS<1 2> <3> 
SGHIGHLIGHTING-3, 1 

The first command sets the segment matching class to be: 



More complex combinations of segment classes can always 
be decomposed into a standard "union of intersections" 
form. For example, consider this expression: 



(class 1) n (class 2) n (class 3) 

The second command sets segment highlighting. Its first 
parameter specifies "all segments in the current matching 
class" (Segment -3), while its second parameter (1) speci- 
fies that highlighting (blinking) is to be enabled for those 
segments. 



[(class 1) U (class 2)] n [(class 3) U (class 4)] 

This can be rearranged by the rules of Boolean algebra, as 
follows: 



[(class 1) n (class 3)] U [(class 1) n (cl ass 4)] 
U [(class 2) n (class 3)] U [(class 2) n (class 4)] 

Thus, to highlight all segments in 



[(UlSSS I) >~l {Uiaao £.)] I I iv^iaoo o; u(i.iaiiaT(| 

you could type the following Setup mode commands: 

SGMATCHINGCLASS < 1 3> 
SGHIGHLIGHTING -3, 1 

Highlights all segments in (class 1) n (class 3). 

SGMATCHINGCLASS <1> <4> 

SGHIGHLIGHTING-3, 1 

Highlights all segments in (class 1) n (class 4). 

SGMATCHINGCLASS <2 3> 
SGHIGHLIGHTING -3, 1 

Highlights all segments in (class 2) n (class 3). 

SGMATCHINGCLASS <2> <4> 

SGHIGHLIGHTING -3, 1 

Highlights all segments in (class 2) D (class 4). 

Of course, a host application program wouldn't use the 
Setup mode commands; it would use the Tek mode SET 
SEGMENT MATCHING CLASS and SET SEGMENT HIGH- 
LIGHTING commands, instead. See the section 4100-Style 
Parameter Types, Commands, and Reports for detailed 
descriptions of these commands. 
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WINDOWS AND VIEWPORTS 



WINDOWS 

A window is a rectangular area in terminal space, and is the 
part of terminal space that you want to view in the graphics 
area of the screen. 



SET WINDOW Command 

To specify the size and location of the window, you send a 
SET WINDOW command. The command includes xy-coor- 
dinate parameters for the lower-left and upper-right corners 
Gt me wiiiuGw. i nsse positions in terminal space are dis- 
played at the corresponding corners of the current viewport. 
(The "current viewport" is the part of the screen where the 
window contents are displayed. The default viewport is the 
entire screen; with the default viewport, the lower-left corner 
of the window maps onto the lower-left corner of the screen, 
and the upper-right corner of the window maps onto the 
upper-right corner of the screen.) 

The display is linearly distorted unless the window has the 
same aspect ratio as the viewport. (Aspect ratio is the ratio 
of height to width.) Figure 3-7 shows different windows 
displaying the same picture in terminal space. The figure 
assumes that the viewport is the default viewport, which 
occupies the entire screen. 



Zoom and Pan 

The operator can place the terminal in Viewing Keys mode 
and use the Zoom, Pan, and View keys to change the size 
and location of the window in terminal space. With the Zoom 
key, the joydisk, and the View key, the operator can "zoom 
in" to examine a part of terminal space in more detail. (That 
is, the operator makes the window smaller, so that a smaller 
part of terminal space is displayed on the screen.) With the 
same keys, the operator can "zoom out" to see more of the 
picture in terminal space. (He makes the window larger.) 
The operator can move the window around in terminal 
space with the Pan key, the joydisk, and the View key. All 
this is described in the Operators Manual. 

For this to work, however, the picture being displayed must 
be defined in the terminal's memory as one or more graphic 
segments. Otherwise, pressing the View key causes the 
terminal to erase its viewport but not to redraw the view. (If 
the terminal doesn't remember the picture, it cannot draw it 
again. For the terminal to remember the picture, it must be 
defined as one or more segments.) 

If you don't want the operator to use the Zoom and Pan 
keys, you can disable them with the LOCK VIEWING KEYS 
command. 

Your applications program can produce a zoom or pan 
effect simply by redefining the window with the SET WIN- 
DOW command. Again, for this to work, the picture being 
displayed must be defined as one or more segments in the 
terminal's memory. 
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Figure 3-7. Examples of Windows. 



4107/4109 PROGRAMMERS 



3-17 



THE GRAPHICS TERMINAL 



VIEWPORTS AND MULTIPLE VIEWS 



SET VIEWPORT Command 

A viewport is a rectangular region on the screen where the 
contents of the corresponding window are displayed. On 
power-up, the terminal's viewport occupies the entire 
screen. You can, however, specify a smaller viewport. To do 
this, send a SET VIEWPORT command, specifying the 
lower-left and upper-right corners of the desired viewport. 
For this command, x-coordinates range from to 4095, and 
y-coordinates from to 3071 . Thus you can get the default 
viewport by sending the command: 

SET VIEWPORT: (0,0), (4095,3071) 

Since the terminal displays the dialog area in front of the 
graphics area, all or part of the viewport can be obscured by 
opaque parts of the dialog area. As explained earlier in this 
section, you can avoid obscuring the viewport by issuing 
commands that make the dialog area invisible or transparent. 



Another way to avoid obscuring the viewport would be to 
place the viewport and the dialog area in different parts of 
the screen. Figure 3-8 shows the technique. The SET DIA- 
LOG LINES: 8 command makes the dialog area occupy the 
bottom fourth of the screen. The SET VIEWPORT com- 
mand causes graphic information to appear in a viewport 
above the dialog area. The SET BORDER VISIBILITY com- 
mand draws a border around the viewport. 



Creating New Views 

You can create several different viewports, each in its own 
part of the screen. Each viewport is associated with a cor- 
responding window in terminal spane ; a list of segments 
visible in that viewport, and a view number. 

In this manual, the word view refers to a collection of several 
things: a viewport, a window, and a list of visible segments. 
A viewport determines where a view appears on the screen. 
A window is in "terminal space" — the coordinate system 
used for drawing the picture — and determines what part of 
a picture is displayed. 
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Figure 3-8. Positioning a Viewport Out of the Way of the Dialog Area. 
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Views are numbered from 1 to 64. On power-up, only one 
view exists: View 1 , with a default viewport occupying the 
entire screen, a default window extending from (0,0) to 
(4095, 31 36). On power-up, View 1 has no visible segments, 
because no segments have been defined. 

To create several different views, each with its own viewport 
in a different part of the screen, proceed as follows: 

1 . Delete all views with a DELETE VIEW: -1 command, 
and erase the screen. After all views are deleted, the 
default view, View 1 , is automatically created, with the 
default window and viewport. 

2. Send a SET VI EWPORT command to change View 1 's 
viewport so that it does not occupy the entire screen. 

3. Create a new view, View 2, and assign a different view- 
port to it. 

a. Send a SELECT VIEW: 2 command. Since View 2 
does not exist, the SELECT VIEW command cre- 
ates a new view and names it View 2, which 
becomes the current view. Initially, the viewport 
and window for View 2 are the same as for View 1 . 



b. Send a SET VIEWPORT command, specifying the 
lower-left and upper-right corners for View 2's 
viewport. 

Draw any picture that you want displayed in View 2's 
viewport. If you want the picture to be retained even 
when zooming and panning, be sure to define the pic- 
ture as part of one or more segments. Since View 2 is 
the current view, these segments are visible in View 2, 
but not in View 1 . 

if you want more than two views, repeat Steps 2 and 3, 
but with a different view number in the SELECT VIEW 
command. View numbers can range from 1 to 64, so 
you can define up to 64 different views. 

Figure 3-9 shows how you might organize the screen 
with two viewports for graphics and a dialog area that 
does not obscure either viewport. 




SFT rSifcfcOG AR£A liMBS: 5 

SET VIEWPORT: (256,768), (SSI 6,2688) 

SET BORDER ViSIBSU'T Y: 1 

SELECT VIEW: 2 

SET VIEWPORT: (3072,768), (3840,2688) 

SET BORDER VISIBILITY; 1 



Figure 3-9. Creating a Screen With Two Viewports. 
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SET VIEW ATTRIBUTES Command 

The SET VIEW ATTRIBUTES command lets you specify 
three attributes of a view's viewport: 

• The surface on which the viewport is located. (Graphic 
display surfaces are explained later in this section.) 

• The wipe index used for erasing the viewport. This is the 
color index to which pixels in the viewport are set when- 
ever the viewport is erased. (Color indices are explained 
later in this section.) 

• The border index. This is the color index used to draw the 
border around the viewport. 

The Setup mode name for this command is VIEWATTRIBU- 
TES. For more information, seethe detailed description of 
the SET VIEW ATTRIBUTES command. 



SURFACES 



INTRODUCTION 

To understand surfaces (and color indices), it helps to know 
a few things about the terminal's design. 

The terminal has several areas of memory, for storing differ- 
ent kinds of information. The general-purpose memory holds 
a variety of things. For instance, graphic segments are 
stored in general purpose memory as lists of graphic dis- 
play commands. The Dialog area buffer holds only dialog 
area text. The nonvolatile memory stores settings that the 
terminal must remember even when power is turned off. 
There is a color map memory. (More about that later.) 
Finally, there is the raster display memory, which relates to 
surfaces. 



View Display Clusters 

Sometimes it is convenient for several views always to 
share the same window coordinates in terminal space. (If 
you zoom in on one view, you zoom in on all.) 

You can accomplish this by grouping the views together in a 
view display cluster. See the SET VIEW DISPLAY CLUSTER 
command's detailed description. 



The terminal's raster memory is used for displaying images 
in the graphics area. The raster memory has one four-bit 
word for each pixel on the screen. Pixels (picture elements) 
are the individual colored dots which together compose the 
image on the screen. 

Refer now to Figure 3-1 0. Think of raster memory as four bit 
planes, each containing one bit (binary digit, or 1) for each 
pixel in the graphics area of the screen. For each pixel in the 
graphics area, there are four bits — one from each bit plane 
— which together compose a binary numeral from 0000 
(decimal 0) to 1 1 1 1 (decimal 1 5). This binary numeral is the 
pixel's color index: it names one of sixteen colors to be 
displayed for that pixel. 
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Fiaure 3-10. Bit Planes in the Terminal's Raster Memory. 
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Table 3-3 shows the default assignments of colors to color 
mixtures. The operator can change these assignments with 
the interactive color interface, described in the Operators 
Manual. The host computer can change these color assign- 
ments with the SET SURFACE COLOR MAP command, 
described later in this section. 

The terminal's internal software draws lines on the screen 
by changing the color indices stored for each pixel in raster 
memory. Circuitry in the terminal then automatically reads 
raster memory and causes the corresponding colors to be 
displayed on the screen. 



Table 3-3 

DEFAULT COLOR MIXTURE 
ASSIGNMENTS 



Color Index 


Color Mixture 





Transparent (Black) 


1 


White 


2 


Red 


3 


Green 


4 


Blue 


5 


Cyan (Blue-Green) 


6 


Magenta 


7 


Yellow 


8 


Orange 
(Red-Yellow) 


9 


Green- Yellow 


10 


Green-Cyan 


11 


Blue-Cyan 


12 


Blue-Magenta 


13 


Red-Magenta 


14 


Dark Gray 


15 


Light Gray 



CREATING MULTIPLE GRAPHICS SURFACES 

On power-up, the situation is as in Figure 3-1 ; there is only 
one graphics surface on which you can draw. However, the 
SET SURFACE DEFINITIONS command lets you split the 
terminal's raster memory among several different surfaces, 
allocating some of the bit planes to each surface. Consider, 
for instance, the following command: 

SET SURFACE DEFINITIONS: 2, 2 

This assigns two raster memory bit planes to one surface, 
and two bit planes to another surface. Surface 1 is in front, 
with Surface 2 behind it, and the solid-color background 
behind Surface 2. If the dialog area is visible, it is in front of 
a!! the n ra n hlcs surfaces. Figure 3-1 1 shows this in terms of 
transparent plastic overlays, while Figure 3-1 2 shows the 
same thing in terms of the raster memory bit planes. 

Initially, there is only one graphics surface (Surface 1), and 
all four bit planes are assigned to that surface. Therefore, 
you can draw images using color indices from to 1 5 
(binary 0000 to binary 1111). However, when you split the 
graphics area into two surfaces, and assign two bit planes 
to each surface, then each surface can only hold color indi- 
ces in the range from to 3 (binary 00 to binary 11). 

When you split the graphics area into more than one sur- 
face with a SET SURFACE DEFINITIONS command, the 
available color indices on each of the two surfaces assume 
the default color mixtures. Thus, on Surface 1 , color index 
means transparent, color index 1 means white, color index 
2 means red, and color index 3 means green. Likewise for 
Surface 2. 

However, once having defined two surfaces, you can assign 
different color mixtures to the indices on each surface. 
(Issue a SET SURFACE COLOR MAP command to set 
Surface 1 's color mixtures. Then issue another SET SUR- 
FACE COLOR MAP command to set the color mixtures for 
Surface 2.) The SET SURFACE COLOR MAP is described 
later in this section, and in the section 4100-Style Parameter 
Types, Commands, and Reports. 
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Figure 3-1 1 . Splitting the Graphics Area Into Two Surfaces. 
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Figure 3-12. Allocating the Bit Planes Between Two Surfaces. 
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ASSIGNING VIEWPORTS TO DIFFERENT 
SURFACES 

Once you have sent a SET SURFACE DEFINITIONS com- 
mand to split the graphics area into more than one surface, 
you can define multiple views as described earlier in this 
section, and place the viewports for these views on different 
surfaces. 

Consider, for example, the following commands: 

SET SURFACE DEFINITIONS: 1,1,2 

Creates three surfaces in the graphics area. Surface 
1 has one bit plane, so you can only draw on it with 
Color Index and Color Index 1 . Likewise for Surface 
2. Surface 3 has two bit pianes, so you can draw on it 
with Color Indices 0, 1 , 2, and 3. 

SELECT VIEW: 1 

Make View 1 the current view. 

SET VIEW ATTRIBUTES: 1 , 0, 1 

Place the viewport for View 1 on Surface 1 , set the 
wipe index for View 1 to Index (transparent) and the 
border index to 1 (white). 

SET VIEWPORT: (51 2,51 2), (2560, 2560) 

Place View 1 's viewport with lower-left corner at 
(51 2,51 2) and upper-right corner at (2560,2560). The 
viewport remains on Surface 1 . 



SELECT VIEW: 2 

Create View 2 and make it the current view. 

SET VIEW ATTRIBUTES: 2, 0, 1 

Place the viewport for View 2 on Surface 2, set its 
wipe index to (transparent) and its border index to 1 
(white). 

SET VIEWPORT: (281 6,51 2),(3584,2560) 

Place the Viewport for View 2 with lower-left corner at 
(281 6,51 2) and upper-right corner at (3584,2560). 

SELECT VIEW: 3 

Create View 3 and make it the current view. 

SET VIEW ATTRIBUTES: 3, 3, 1 

Place the viewport for View 3 on Surface 3, set its 
wipe index to 3 (green) and its border index to 1 
(white). 

Figure 3-13 shows the results of these commands. Note that 
Viewport 3 has the same lower-left and upper-right coordi- 
nates as Viewport 2, although it is on a different surface. 
When you create a new view with the SELECT VIEW com- 
mand, the viewport for that view has the same boundaries 
as the viewport for the previous view — until you change 
them with the SET VIEWPORT command. 
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Figure 3-13. Placing Viewports on Different Surfaces. 
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COLOR DISPLAY 

When a command specifies the color of something on the 
screen, it does not state an absolute color, such as light 
green or bluish-gray. Instead, it specifies an integer called a 
color index. Either a host program or the operator can select 
the color associated with a particular color index. For exam- 
ple, when the terminal is shipped from the factory, Color 
Index 2 is set to mean red. So, anything you assign to Index 
2 is displayed in red. If you then change Index 2's definition 
to blue, anything displayed in Index 2 is blue. 



COLOR INDICES 

A color index must be an integer in the range from to 1 5. 
Actually, the maximum value is 2"-1 , where n is the number 
of bit planes associated with the surface on which you are 
drawing. For instance, on power-up, there is only one sur- 
face, and that surface has four bit planes; since 2 4 -1 is 15, 
you can draw on that surface with color indices in the range 
from to 15. 

However, suppose you define two graphics surfaces with a 
SET SURFACE DEFINITIONS command: Surface 1 , with 
one bit plane, and Surface 2, with three bit planes. On Sur- 
face 1 , 2 1 -1 is 1 , so you can draw on Surface 1 with only 
color indices and 1 . Surface 2 has 3 bit planes, and 2 3 -1 is 
7, so you can draw on Surface 2 with color indices in the 
range from to 7. 

The dialog area has its own set of eight color indices. 

The color that a color index produces can be set in several 
ways. When the terminal is turned on, the color indices are 
assigned default colors. A host program can assign colors 
with the SET SURFACE COLOR MAP and SET DIALOG 
AREA COLOR MAP commands. The operator can assign 
colors with the color interface, which is described in the 
Operators Manual. The operator can also assign colors in 
the graphics area with the Setup mode command, CMAP, 
and in the dialog area with the Setup command, DACMAP. 



COLOR COORDINATES 

Colors for color indices are defined in terms of three color 
coordinates. You can use any of three systems of color 
coordinates: HLS, RGB, or CMY. 

• HLS (Hue, Lightness, Saturation). This is the easiest 
color coordinate system to understand; it is based on a 
double-ended color cone, which is illustrated in the 
appendices. The hue coordinate runs from 0° to 360°, 
and specifies whether the color mixture is a shade of red, 
of magenta, of blue, of cyan, of green, or of yellow, etc. 
The lightness coordinate runs from 0% to 1 00% — from 
black, through shades of gray, to white. The saturation 
coordinate runs from 0% to 100% and specifies how 
vivid the color is; 0% would represent a shade of gray, 
while 100% represents a vivid, fully saturated hue. 

• RGB (Red, Green, Blue). The RGB color coordinate 
system represents colors as mixtures of red, green, and 
blue light. For instance, 100% red, 0% green, and 0% 
blue yields red, while 100% red, 100% green, and 100% 
blue yields white. 

• CMY (Cyan, Magenta, Yellow). The CMY color coordi- 
nate system approximates the mixing of cyan, magenta, 
and yellow inks to produce color mixtures. For instance, 
cyan and yellow ink mix to produce a green color, so 
CMY color coordinates of 100% cyan, 0% magenta, and 
1 00% yellow would yield a green color mixture. 

To select a color coordinate system, issue a SET COLOR 
MODE command or the Setup mode CMODE command. 
(The operator's color interface, however, always uses the 

HLS system.) 
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DEFINING COLOR MIXTURES 

Once you have selected a color coordinate system with the 
SET COLOR MODE command, you can define a color mix- 
tures. Remember, however, that Color Index means trans- 
parent. (The exception is when index is used as the 
character color in the dialog area. In that case, index 0, like 
other color indices, means a particular color mixture.) 

To define color mixtures on surfaces in the graphics area, 
use the SET SURFACE COLOR MAP command or the 
Setu n mode CMAP command. To define the color mixture 
for the background which lies behind all the transparent 
writing surfaces, use the SET BACKGROUND COLOR 
command or the Setup mode CBACKGROUND command. 

To define color mixtures in the dialog area, use the SET 
DIALOG AREA COLOR MAP command, or the Setup mode 
DACMAP command. 

These commands are described in detail in the section 
4 100-Style Parameter Types, Commands, and Reports. 

BLINKING COLORS 

One way to make graphics (or text displayed in the graphics 
area) to blink on and off is to draw it using a color index that 
you reserve for blinking objects, and then define the color 
mixture for that color index to be a blinking color mixture. 
You do this by adding 1 000 to the third color coordinate in 
the SET SURFACE COLOR MAP command. 



For instance, suppose you have drawn a picture which 
includes some graphic text. Reserve a special color index 
for the text which you want to be able to blink on and off: 
say, color-index 15. When you want to make the text blink, 
issue a SET SURFACE COLOR MAP command in which 
you define index 15 to be, say, "blinking red," as follows: 

SET SURFACE COLOR MAP: 1, 15, 120,50, 1100 

In the HLS color coordinate system, this would mean, "on 
Surface 1 , set Color Index 15 to mean HUE 120° (red), 
LIGHTNESS 50%, and SATURATION 1 100 (100% satura- 



When you want to turn the blinking off, you could issue 
another command to set the color index for index 1 5 to be, 
say, "nonblinking white," as follows: 

SET SURFACE COLOR MAP: 1, 15, 0, 100, 1000 

This would mean, "on Surface 1 , set Color Index 15 to 
mean HUE 0°, LIGHTNESS 100% (white), SATURATION 
(0% saturation, no blinking). 

(There are, however, other ways to make objects biink. You 
can blink a graphic segment with the SET SEGMENT HIGH- 
LIGHTING command. You can blink an entire graphics 
surface with the SET SURFACE VISIBILITY command. In 
the dialog area, you can set a "blink" attribute for subse- 
quent characters with the ANSI mode SGR command.) 



4107/4109 PROGRAMMERS 



3-27 



THE GRAPHICS TERMINAL 



EFFECTIVE COLOR DISPLAYS 



ENABLING FOR GRAPHICS INPUT 



Color can be used effectively in a number of ways. Some 
examples are: 

• Separating categories of information. 

• Helping the operator locate a particular object in a com- 
plex display. 

• Cuing the operator that information has changed. 

• Making small symbols (such as markers) more obvious. 

Keep these points in mind when assigning colors: 

• The basic set of colors (red, yellow, green, cyan, blue, 
and magenta) can be readily distinguished one from 
another and recognized by name. When adding interme- 
diate colors, take care that all the colors are distinguish- 
able. 

• Blue text, symbols, and lines often appear fuzzy. It is best 
to avoid fully saturated blue (HLS = 0, 50, 1 00) for text, 
symbols, and thin lines. 

• Use the same color the same way in different pictures; 
this makes it easier to recognize the color's meaning 
quickly. 

• Maintain both a lightness and color difference between 
characters and their backgrounds. Yellow text on a dark 
gray background (or the reverse) is highly visible, 
whereas yellow on a cyan background is not. 

• Highly saturated colors often evoke a false depth percep- 
tion in which some colors stand out from the surface 
while others recede. For complex displays, it is wise to 
desaturate the colors somewhat. 



GRAPHICS INPUT 

Graphics input (GIN) tells a program where the graphics 
cursor is when the operator presses a key. It also tells which 
key is pressed. 



The terminal has two commands which enable it for graph- 
ics input: 

• The ENABLE 401 GIN command does simple graphics 
input in the same way as Tektronix 4010 Series terminals 
and the Tektronix 41 05 terminal. 

• The ENABLE GIN command provides more features, 
and more flexible graphics input. This command lets you 
specify a different GIN device than the joydisk, such as 
an accessory graphics tablet. It lets you enable the termi- 
nal for more than than one input point per command. 
Besides the "locator" GIN function, it lets you specify a 
"pick" function for selecting segments and a "stroke" 
function for inputting many points from a graphics tablet. 
You can even enable several GIN devices at once, by 
issuing several ENABLE GIN commands. 



TYPICAL GRAPHICS INPUT SEQUENCES 

These steps describe graphics input with the ENABLE 4010 
GIN command: 

1 . The host issues the ENABLE 401 GIN command. This 
puts the terminal in GIN mode, and causes it to display 
the graphics cursor. 

2. The operator uses the joydisk to move the graphics 
cursor. When the cursor is at the desired position, the 
operator presses one of the ASCII keys. 

3. The terminal then sends a 4010 GIN REPORT to the 
host computer. This report tells the host which key was 
pressed and the location of the graphics cursor. On 
sending the report, the terminal exits GIN mode and 
ceases to display the graphics cursor. 

The host must send a separate ENABLE 401 GIN com- 
mand for each point. 
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While the terminal is in GIN mode, certain keys are special: 

• If the dialog area is enabled, the terminal ignores the 
PAGE command and the c r character. 

• If the dialog area is disabled, the G Eras key, PAGE com- 
mand, or c r character end GIN mode and put the termi- 
nal in Alpha mode; no report is sent to the host. 

These steps describe typical graphics input with the 
ENABLE GIN command: 

1 . The host sends a SET REPORT SIG CHARS com- 

~_.J Tut*. *..~~**:«;<*»* +U« +U« "ninnn+i irn nlnnm*****.**." 
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which the terminal will insert into the GIN report mes- 
sages to (a) tell the host which of several possible GIN 
devices caused a particular report message to be sent, 
and (b) notify the host when the last of several GIN 
report messages has been sent. 

2. The host may send other commands to set other GIN 
parameters. These parameters are listed in Table 3-4. 

3. The host sends an ENABLE GIN command. This puts 
the terminal in GIN mode, specifies which GIN device is 
to be used for entering graphicscoordinates, which of 
three GIN functions (locator, pick, or stroke) is to be 
performed, and how many coordinates the terminal is 
to send to the host before exiting GIN mode. 

For instance, the host might specify, "Enable GIN for 
5000 'locator' events using the joydisk." 

4. The terminal is now in GIN mode, and displays the 
graphics cursor. This may be the crosshair cursor, or it 
may be another cursor chosen by the host in Step 2. 

5. The operator uses the joydisk (or whatever GIN device 
was specified in the ENABLE GIN command) to move 
the graphics cursor around the screen. 

6. When the cursor is where the operator wants it to be, 
the operator signals a GIN event. The operator does 
this by pressing a key (if using the joydisk) or pressing a 
tablet stylus or tablet puck button (if using an accessory 
graphics tablet). 



7. The terminal sends a GIN report to the host computer. 
This is a GIN LOCATOR REPORT, GIN PICK REPORT, 



• GIN STROKE RE 
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GIN device was enabled for the locator, pick, or stroke 
graphics input function. 

8. Steps 5 and 6 are repeated until either (a) the number 
of GIN events specified in the ENABLE GIN command 
have occurred, or (b) the operator presses the CANCEL 
key to remove the terminal from GIN mode. 

9. The terminal sends one last report to the host, telling it 

UICU II I lOO CAIIOU \Jlli-<i IIIUUS. ^IIII^IOUICI ni^Vi- v*m-« 

REPORT ITEM included with the GIN REPORT 
SEQUENCE detailed description.) 



LOCATOR, PICK, AND STROKE FUNCTIONS 

There are three graphics input functions: locator, pick, and 
stroke. All three functions are available with the ENABLE 
GIN command. The ENABLE 401 GIN command, however, 
supports only the locator function. 

With the locator function, the terminal reports the location of 
the cursor and which key the operator pressed. 

The pick function lets the operator pick a segment (graphics 
object) by pointing to it with the cursor. The terminal reports 
the cursor position, which key was pressed, which segment 
was picked, and even which part of the segment was 
picked. (Parts of a segment can be labled with different 
"pick identification numbers" by issuing SET PICK ID com- 
mands when the segment is defined.) 

The stroke function is only for use with an accessory graph- 
ics input tablet. It lets the operator input a stream of points 
by stroking the stylus or puck across the tablet surface. The 
SET GIN STROKE FILTERING command lets you specify 
how close together the reported points may be, either in 
space or in time. 
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GRAPHICS INPUT COMMANDS 

Table 3-4 lists the GIN commands. For more details, see the 
command descriptions in the section 4100-Style Parameter 
Types, Commands, and Reports. 



GRAPHICS INPUT REPORTS 

When the terminal is enabled for GIN with the ENABLE 
4010 GIN command, it sends its GIN report message back 
to the host in the 4010 GIN REPORT format. For more infor- 
mation, see the 4010 GIN REPORT detailed description. 



When the terminal is enabled for GIN with the ENABLE GIN 
command, it sends its report messages back to the terminal 
in the GIN REPORT SEQUENCE format. If it was enabled 
for the locator function, the GIN REPORT SEQUENCE 
includes zero or more GIN LOCATOR REPORTS. Likewise, 
if enabled for the pick or stroke function, the GIN REPORT 
SEQUENCE includes GIN PICK REPORTS or GIN STROKE 
REPORTS. See the detailed descriptions of GIN REPORT 
SEQUENCE, GIN LOCATOR REPORT, GIN PICK REPORT, 
and GIN STROKE REPORT for more information. 

While the terminal is sending a report to the host, the termi- 
nal is in Bypass mode. While in this mode, the terminal 
ignores input from the host. After the message is sent, the 
terminal returns to Alpha mode. (Bypass mode is explained 
in the Qoiv.YP.uniccttiofis section.^ 



Table 3-4 
GRAPHICS INPUT COMMANDS 



Command Name 


Setup Mode Name 


Function 


ENABLE 4010 GIN 


(none) 


Enables the terminal for one GIN locator event with the joydisk. 


ENABLE GIN 


GINENABLE 


Enables the terminal for one or more locator, pick, or stroke events 
with the joydisk or an accessory tablet. 


DISABLE GIN 


GINDISABLE 


Cancels the effect of an ENABLE GIN command. 


SET GIN CURSOR COLOR 


GCURSOR 


Specifies the color mixture for the crosshair cursor. 


SET GIN AREA 


GINAREA 


Specifies which area on a GIN tablet corresponds to a specified 
window in terminal space. This may be the window for the current 
view, or it may be the window specified by SET GIN WINDOW. 


SET GIN WINDOW 


GINWINDOW 


Specifies a window in terminal space onto which the GIN area is 
mapped. 


SET PICK APERTURE 


GINAPERTURE 


Specifies how close the cursor must be to a segment in order to 
"pick" that segment. 


SETGINGRIDDING 


GINGRIDDING 


Constrains the GIN cursor to lie only at the intersection points of an 
invisible grid. 


SET GIN INKING 


GININKING 


Causes the terminal to draw lines from one graphic input point to 
the next. 


SET GIN RUBBERBANDING 


GINRUBBERBANDING 


Causes a "rubber band line" to be displayed from the last graphic 
input point to the cursor position. 


SET GIN DISPLAY START POINT 


GINSTARTPOINT 


Specifies a starting point for the first rubberband line and the first 
inking line. 


SET GIN STROKE FILTERING 


GINFILTERING 


For "stroke" input from a tablet, specifies how close the input points 
may be in space or in time. 
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MACROS 



INTRODUCTION 

A macro is a string of characters identified by an integer 
called the macro number. Either the host or the operator 
can assign a string to a macro number. The host uses the 
DEFINE MACRO or DEFINE NONVOLATILE MACRO com- 
mand, while the operator uses the DEFINE or NVDEFINE 
Setup mode commands. 

After a macro is defined, a host program can issue an 
EXPAND MACRO command, which specifies a macro num- 
ber. (The operator can use the EXPAND Setup mode com- 
mand.) The terminal looks up the macro assigned to that 
macro number and uses that string. 

For example, a host program can define macro 301 to be 
the string, "Type any key to continue." Then, anytime the 
program needs this string displayed, it could just send an 
EXPAND MACRO: 301 command. When the terminal 
receives this command, it looks up macro 301 in its memory 
and displays the string it finds. 

Likewise, the host could send a DEFINE MACRO command 
to define macro 302 to be a commonly used sequence of 
commands to the terminal. Thereafter, the host could issue 
the single command, EXPAND MACRO: 302 whenever it 
would otherwise send that sequence of commands to the 
terminal. 

Macros are also used another way. Each key or key combi- 
nation indicates a particular macro number. If a macro is 
defined for a key's macro number, then when the operator 
presses that key, the terminal looks up the macro and uses 
the string of characters it finds instead of the character the 
key normally produces. A macro that can be expanded by 
pressing a key is called a key macro. 



HOST MACROS 

Host macros are those macros that can only be expanded 
by the EXPAND MACRO command. If the macro is a termi- 
nal command, the terminal executes that command when 
the macro is expanded. If the macro is not a command, it is 
displayed on the screen, just like any message from the 
host. 

Macros are efficient in many operations. For example, 
instead of sending a long string of characters, the host can 
send the much shorter EXPAND MACRO command. This 
saves data transmission time and ensures that the terminal 
receives the same string each time a particular macro is 
expanded. 

KEY MACROS 

Each key or key combination is matched to a macro number 
(see the detailed description of the DEFINE command). For 
keys that produce ASCII characters, the associated macro 
number is the ASCII decimal equivalent of that character. 
For example, the ASCI! decimal equivalent of uppercase P 
is 80. If macro number number 80 has been defined, press- 
ing uppercase P produces that macro. (If macro number 80 
has not been defined, pressing uppercase P just produces 
the uppercase P character.) 

Besides being expanded by a keystroke, key macros can 
also be expanded by EXPAND MACRO, just like host 
macros. 



Disabling Key Macros 

Key macros can be enabled or disabled with the ENABLE 
KEY EXPANSION command (or the Setup version KEYEX- 
PAND). When key macros are disabled, only their expan- 
sion by pressing keyboard keys is disabled; it is still 
possible to expand them with the EXPAND MACRO com- 
mand. 



Key macros are automatically disabled whenever a 
SELECT CODE: 2 command or Setup mode CODE EDIT 
command puts the terminal in Edit mode. (The operator can 
reenable them with the KEYEXPAND YES Setup mode 
command.) 
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LEARN and NVLEARN Commands 

You can easily define key macros from the keyboard with 
the LEARN or NVLEARN Setup mode commands. These 
commands let you define a key macro by pressing the keys 
that make up the sequence instead of entering key codes. 
See the Operators Manual for details. 



Keeping a Key Macro Local 

Normally, when you press a key, the macro defined for that 
key is sent to the host computer — just as if you had typed 
that sequence of characters on the keyboard. However, you 
might want a key macro only to be displayed on the screen, 
or you might want a key macro to be interpreted as a com- 
mand to the terminal. In these cases, you do not want the 
macro sent to the host, but want it executed locally. To cre- 
ate such a macro, follow these steps: 

1 . Send the SET KEY EXECUTE CHARACTER command 
to the terminal. This command defines one character to 
be the key execute character. When this character is in a 
macro, it means that following characters should be 
used locally until the key-execute character again 
appears in the macro. 

2. Send the DEFINE MACRO command to define the 
macro. Put a key-execute character at the beginning 
and end of the string. 

When the defined key is pressed, the characters 
enclosed by the key-execute characters are used 
locally. If these characters are a terminal command, 
they are executed. If they are not a terminal command, 
they are displayed as if the operator typed them . The 
characters are not sent to the host. 



Key-execute characters in macros expanded by an 
EXPAND MACRO command have no special meaning; 
they are treated just like other characters in the macro. 
Macros expanded by the EXPAND MACRO command 
sent by the host computer are always treated just as if 
they were sent by the host. (Macros expanded by an 
EXPAND MACRO command typed by the operator in 
Local mode, or by a Setup mode KEYEXPAND com- 
mand, are always treated as if they were typed by the 
operator.) 




When defining a macro 10 be used locally, be sure 
to include the second key-execute character. Other- 
wise, key macros are used locally until the terminal 
encounters another key-execute character. 



VOLATILE AND NONVOLATILE MACROS 

The terminal can store a macro in two ways. A volatile 
macro is stored in volatile memory — the macro is not 
retained when the terminal is turned off or reset. A nonvola- 
tile macro is stored in nonvolatile memory, and is remem- 
bered even when the terminal is turned off or reset. When 
the terminal is turned on or reset, all nonvolatile macros are 
retained. 

A macro can be stored in both volatile and nonvolatile mem- 
ory at the same time. When expanding a macro, the termi- 
nal checks the volatile memory first. If it does not find the 
macro in volatile memory, the terminal looks for it in nonvol- 
atile memory. 

The DEFINE MACRO command (in Setup, DEFINE) defines 
only the volatile version of a macro. The DEFINE NONVOL- 
ATILE MACRO command (in Setup, NVDEFINE) defines 
both the volatile and nonvolatile versions of a macro. To 
actually save the nonvolatile version in nonvolatile memory, 
however, you must issue a SAVE NONVOLATILE PARAME- 
TERS command (NVSAVE in Setup) before turning off or 
resetting the terminal. 
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DEFINING GRAPHTEXT 
CHARACTERS 

You can define your own stroke precision graphtext charac- 
ters. For string precision graphtext and alphatext, however, 
you must use the predefined character character fonts. 

GENERAL PROCEDURE 

To define your own stroke precision graphtext characters, 
proceed as follows: 

1 . Decide on a font number for your stroke precision font. 
Then delete all characters in that font, and set up a font 
grid for the characters you will define. For example, if 
you choose Font 2, the commands might be: 

DELETE GRAPHTEXT CHARACTER: 2, -1 
SET GRAPHTEXT FONT GRID: 2, 60, 100 

This deletes all user-defined characters in stroke preci- 
sion Font 2, and sets up a font grid for defining charac- 
ters in that font. When defining a character in this 
example, the model character cell (font grid) extends 
from X = to X = 60, and from Y = to Y = 1 00. (These 
TSU coordinates are only used for defining the stroke 
precision characters. When stroke precision graphtext 
is displayed using this font, the model character cell will 
be scaled to the size set by the SET GRAPHTEXT SIZE 
command.) 

2. Set a pivot point for subsequent graphtext characters. 
This point in the font grid is used as the lower left cor- 
ner of the graphtext character. By setting a pivot point 
higher than Y = 0, you can allow for descenders in 
lowercase letters. 

SET PIVOT POINT: (0,20) 



3. Define the individual graphtext characters: 

a. Send BEGIN GRAPHTEXT CHARACTER to start a 
character definition. For instance, 

BEGIN GRAPHTEXT CHARACTER: 2, 65 

starts the definition of character number 65 in 
stroke precision font number 2. 

b. Draw lines in the model character cell to define the 
character. Use either the Vector mode or the 
MOVE-and-DRAW technique for drawing lines. 

c. End the character definition with an END 
GRAPHTEXT CHARACTER command. 

d. Repeat steps a through c for other stroke precision 
graphtext characters. 

For detailed information, see the descriptions of the SET 
GRAPHTEXT FONT GRID, BEGIN GRAPHTEXT CHARAC- 
TER, END GRAPHTEXT CHARACTER, and DELETE 
GRAPHTEXT CHARACTER commands. 



4107/4109 PROGRAMMERS 



3-33 



THE GRAPHICS TERMINAL 



PIXEL OPERATIONS 



WAYS OF USING PIXEL OPERATIONS 



INTRODUCTION 

Pixel operations give you a much faster way way to place 
images on the screen or modify images currently there. You 
can use pixel commands to quickly display and transmit 
very complex images — much more quickly than with line or 
panel graphics commands. Unlike line graphics that make 
up images with a series of MOVEs and DRAWs, pixel opera- 
tions compose images with groups of pixels. 

The disadvantage of pixel operations is that the images are 
stored only in raster memory; pixel images cannot he stored 
as segments in the terminal's general memory. Conse- 
quently, once you erase the screen, the pixel image is gone; 
you must retransmit it to display it again. (Segments, on the 
other hand, can be made invisible and then visible again, 
with the SET SEGMENT VISIBILITY command.) 

A pixel is the smallest screen element that a terminal can 
address. If you display a single pixel on the screen, you will 
see a tiny dot of color. If all the pixels in a given area are the 
same color, then the area is that color. But if the pixels in an 
area alternate between two or more different colors, the 
area appears to be a color different from any of the individ- 
ual pixels. 

Each pixel on the screen corresponds to a memory location 
in the terminal's raster memory. (The raster memory was 
described earlier in this section, in connection with bit 
planes and surfaces.) As the terminal scans across the 
raster memory, it reads the number stored in each location. 
That number represents a color index in the color map. The 
terminal reads color indices from raster memory, looks in 
the color map for the entries corresponding to those indices, 
and displays the pixels using the color mixtures defined by 
those entries. Thus, the screen display is a visual copy of 
the contents of raster memory; and by changing the con- 
tents of raster memory, you change the image on the 
screen. One way to do this is to use pixel operations. 



ALU Mode 

All pixel writing operations use an ALU mode parameter, 
set by the BEGIN PIXEL OPERATIONS command. The ALU 
mode determines how the new color index information in a 
pixel writing command will affect the pixel information cur- 
rently stored in raster memory. Depending on the ALU 
mode, a pixel writing operation may erase the screen, 
replace one image with another, or combine images. See 
the BEGIN PIXEL OPERATIONS command's detailed 
description. 



Off-Screen Memory 

One feature of pixel operations is the off-screen memory. 
This is an area of raster memory that is not visible on the 
screen but can be written to and copied from. You can use 
off-screen memory as a scratch pad, or as a storage area 
where you can store images for later retrieval. For example, 
you could store a special graphics character font in off- 
screen memory and retrieve each character as it was 
needed with a PIXEL COPY command. 

In the 41 07 and 41 09 terminals, the on-screen pixel memory 
extends, in pixel coordinates, from X = to X = 639, and 
from Y = to Y = 479. The off-screen pixel memory extends 
from X = to X = 639, and from Y = 480 to Y = 51 1 . 



Differences Between Terminals 

You should be aware that the results of pixel commands 
differ significantly between different Tektronix terminals, 
primarily because of the different dimensions of raster 
memory. If you write a program for this terminal that uses 
pixel commands, you may have to rewrite the program in 
order to make it work with another Tektronix terminal. This is 
especially true if your program uses the off-screen memory. 
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WRITING INTO THE PIXEL VIEWPORT 

You can access the individual pixels of the terminal's raster 
memory using the pixel commands. Three of the commands 
prepare the terminal for writing pixels: BEGIN PIXEL OPER- 
ATIONS, SET PIXEL VIEWPORT and SET PIXEL BEAM 
POSITION. The pixel-writing commands (RASTER WRITE, 
RUNLENGTH WRITE, PIXEL COPY, and RECTANGLE 
FILL) provide varied methods of setting color indices for 
pixels. 

Thg following exam n !es brief!" explain each of these com- 
mands, except for PIXEL COPY. (The PIXEL COPY com- 
mand copies pixels from one rectangular region in raster 
memory space to another rectangular region.) Refer to the 
command descriptions in the section 4100-Style Parameter 
Types, Commands, and Reports for additional information 
about these commands. 

Figure 3-1 4 shows commands that define a pixel viewport 
and write some color indices into that pixel viewport. (The 
commands are shown both in Setup syntax and in Host 
syntax.) Let's consider these commands, one by one. 



PXBEGIN. In this example, no parameter values are given. 
Therefore, the PXBEGIN (BEGIN PIXEL OPERATIONS) 
command assumes default parameters 1,11, and 6. These 
parameters specify Graphics Surface 1 as the pixel-writing 
surface, set the ALU mode to 1 1 (Replace mode), and spec- 
ify that 6 bits per pixel be used to transmit each color index. 

PXVIEWPORT 100 100 109 109. The PXVIEWPORT (SET 
PIXEL VIEWPORT) command defines a rectangular region 
on the pixel writing surface. In this example, the lower-left 
and upper-right corners of the pixel viewport are at 
(100,100) and (109,109), respectively. These coordinates 
are in 640-by-480 raster memory space. (If you include the 
off-screen memory, the coordinates would be in "640-by- 
51 2" raster memory space.) 

PXRECTANGLE 100 100 109 109 0. The PXRECTANGLE 
(RECTANGLE FILL) command sets all pixels within a rec- 
tangular region to the same color index. In this example, the 
command clears the pixel viewport by setting all pixels in 
that region to Color Index 0. 



Setup Command 

PXBFGIN 

PXVIEWPORT 100 100 109 109 
PXRECTANGLE 100 100 109 109 
PXPOSITION 3 4 
PXRASTERWRITE 4 4002" 
rwubi i ium o o 
PXRASTERWRITE 4 "4217" 
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Host Syntax 




E cRU1;6 




E cRS s pe{ s p[ s P 


ySpY 


EcRSSpejSplSp 


y s P Y0 


E cRH s pca s p@ 




E cRP444002 








E cRP444217 





PIXCL VIEWPORT 



DISPLAY 



■■■■.'' 



Figure 3-1 4. Writing Into the Pixel Viewport Using RASTER WRITE. 
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PXPOSITION 3 4. The PXPOSIITON (SET PIXEL BEAM 
POSITION) command moves the current pixel position (the 
point where the next pixel will be written) to the point (3,4). 
These coordinates are relative to the lower-left corner of the 
pixel viewport. 

PXRASTERWRITE 4 "4002". The PXRASTERWRITE 
(RASTER WRITE) command writes the color indices 4, 0, 0, 
and 2 into four successive pixels. At the end of this com- 
mand, the pixel beam position is at (7,4). These coordinates 
are relative to the lower-left corner of the pixel viewport. 

PXPOSITION 3 3. This moves the current pixel position to 
the location (3,3) in pixel viewport coordinates. 

PXRASTEWRWRITE 4 "4217". This writesthe color indi- 
ces 4,2,1, and 7 into four successive pixels. At the end of 
this operation, the pixel beam position is at (7,3) in pixel 
viewport coordinates. 

You can use PXRUNLENGTHWRITE (RUNLENGTH 
WRITE) commands as well as PXRASTERWRITE (RASTER 
WRITE) commands to write in the pixel viewport. 
PXRUNLENGTHWRITE (using an array of specially 
encoded integers called runcodes) specifies the number of 
pixels in a sequence, and sends the same color index to 
each pixel in the sequence. The next three paragraphs and 
Figure 3-1 5 explain how this is done. 



As in Figure 3-14, Figure 3-1 5 uses PXBEGIN (this time with 
bits-per-pixel set to 3) and PXVIEWPORT commands to 
define a pixel viewport that is ten pixels wide and ten pixels 
high. As before, a PXRECTANGLE command clears all 
pixels in the pixel viewport to Color Index 0. This time, how- 
ever, there is no PXPOSITION command, so the current 
pixel position starts at the upper-left corner of the pixel 
viewport. 

In this example (Figure 3-15), the RUNLENGTH WRITE 
command has four runcodes in its integer-array parameter. 
Each runcode is a single number into which two other num- 
bers are packed. The runcodes are packed using the form: 

Runcode = number-of-pixels x 2" + color-index 

where n = number-of-bits-per-pixel 

The bits-per-pixel parameter from the most recent BEGIN 
PIXEL OPERATIONS command supplies the value for n 
unless that parameter is 6; then the value of n is 3. 

The first code, 160, calls for 20 pixels of Color Index 0. (20 x 
2 3 + = 160.) The second code, 243, calls for 30 pixels of 
Color Index 3 (30 x2 3 + 3 = 243.) The third code, 160, calls 
for 20 pixels of Color Index 0; it is the same as the first code. 
The fourth code, 246, calls for 30 pixels of Color Index 6 (30 
x 2 3 + 6 = 246.) 



Setup Command 




Host Syntax 




PXBEGIN 1 11 
PXVIEWPORT 10 
PXRECTANGLE I 
PXRUNLENGTHW 

... • : • . . .... ......... ... ■ , .... v • :..;.. ... . 1 . 


3 

O 100 109 109 

00 100 109 109 

RITE 160 243 160 246 


E cRU1;3 

EcRS'-Vei'SpppVpY 
E cRR s pe{ s pf y s pY0 
E cRL4J003J006 




0000000000 


r'"'""""""''"" .. . ■ .. -i 




0000000000 
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Figure 3-15. Writing Into the Pixel Viewport Using RUNLENGTH WRITE. 
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INTRODUCTION 

This section covers the text entry and editing functions of 
the terminal. The topics covered are: 

• Screen Editing Concepts. Explains how screen editing 
differs from line editing and how this terminal's cursor 
works. Also explains how the dialog area works with 
screen editing programs. 

• Screen Editing Operating Modes. Discusses the termi- 
nal's editing modes, how they relate to one another, and 
what functions each mode performs. 

• Ansi and VT52 Mode Command Syntax. Describes the 
conventions used in this manual to represent syntax and 
gives a few tips about syntax rules for these modes. 

• Ansi Mode Commands. Starts with a list of commands 
by function and goes on to describe each command in 
detail. 

• VT52 Mode Commands. Describes each VT52 mode 
command in detail. 



SCREEN EDITING CONCEPTS 



Screen editing programs allow you to view and edit a com- 
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use most screen editing programs with this terminal as long 
as the program is compatible with the ANSI X3.64 and ISO 
6429 standards. The documentation supplied with your edit- 
ing program should define any deviation from these 
standards. 

You may not be able to use all of your program's features 
with this terminal, and your program may not be able to use 
all of this terminal's features. The detailed command 
descriptions provided later in this section explain how the 
terminal responds to each particular command. 



If your editing program is compatible with VT52 terminals, 
use VT52 mode; if your editing program is compatible with 
VT1 00 terminals, use Edit mode. These modes configure 
the terminal to run most VT52 or VT1 00 applications 
programs. 

If you write your own program, it must conform to the com- 
mands described in this section. 



THE CURSOR 

The cursor is an underline displayed on the screen; it serves 
as a pointer that indicates where commands should take 
place. For example, to delete a character, you first move the 
cursor to that character, then issue the command that 
deletes it. 

The line of text on which the cursor is located is referred to 
in this manual as the current line. The position of the cursor 
on that line is referred to as the cursor position. 

This terminal's cursor is fully addressable. Each character 
on the screen has a unique horizontal row and vertical 
column address. You can specify exact cursor positions 
using these row and column addresses. 

The cursor is displayed on the screen as an underline. You 
can make the cursor blink and you can choose its color; use 
the SET ALPHA CURSOR INDEX 1 command. To select the 
display style and color for text, use the SGR (Select Graphic 
Rendition) command, described later in this section. 

THE DIALOG AREA 

The dialog area is a display area of the terminal that is sepa- 
rate from the graphics area. All text editing and entry occur 
in the dialog area, and the Ansi and VT52 mode commands 
work only in the dialog area. Before executing any screen 
editing programs, make the dialog area visible with the SET 
DIALOG AREA VISIBILITY' command, or by pressing the 
Diaiog key. 



These are Tek mode commands and are described in the section titled 
4100-Style Parameter Types, Commands, and Reports. 
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The dialog buffer can have as many lines as there is mem- 
ory to hold them, with up to 32 lines visible on the screen at 
any one time. (The dialog area is part of the dialog buffer.) 
You can set the number of lines in the dialog buffer with the 
SET DIALOG AREA BUFFER SIZE 1 command. You can set 
the number of lines that are visible with the SET DIALOG 
AREA LINES 1 command. If the dialog buffer has more than 
32 lines, the excess lines are not visible on the screen, but 
can be scrolled into view. (When the terminal is set to dis- 
play 1 32 columns, it can only display 30 lines.) 

If the cursor is visible, the dialog buffer rolls up or down as 
you move the cursor, so that the cursor always remains in 
view. The exceptions to this are the SU (Scroll Up) and SD 
(Scroll Down) commands (and the equivalent ioydisk move- 
ments). These commands scroll the dialog buffer up or 
down and the cursor maintains its position within the dialog 
buffer; therefore, the cursor move out of view. 

If the cursor is not visible, cursor movement commands do 
not scroll the dialog buffer. 



These are Tek mode commands and are described in the section titled 
4100-Style Parameter Types, Commands, and Reports. 



Scrolling Regions 

The Ansi mode command set allows the terminal to have up 
to two fixed regions and one scrolling region on the screen at 
the same time. This can be useful when, for example, your 
screen editing program has a status or message line at the 
top or bottom of the text editing region; the editing region is 
the scrolling region and the status lines are the fixed 
regions. 

You can set the edit margins of the scrolling region with the 
TEKSTBM (Set Top and Bottom Margins) command. If the 
edit margins coincide with the terminal screen size, then 
there are no fixed regions and the scrolling region is the 
entire dialog buffer. Otherwise, the lines between and 
including the edit margins are in the scrolling region and the 
lines outside the scrolling region are in the fixed regions. 

The cursor can be moved from the scrolling region into a 
fixed region only if Origin mode is set to Absolute (done 
automatically in Edit mode). Use the CUP (Cursor Position) 
or HVP (Horizontal and Vertical Position) command to move 
from one region to the other. Figure 4-1 shows how the dia- 
log buffer and edit margins relate to the terminal display. 

Origin mode determines how the cursor is addressed in 
these fixed and scrolling regions. In Origin mode Absolute, 
you can address any character position on the screen rela- 
tive to the upper-left character position of the visible portion 
of the dialog buffer (character address Row 1 , Column 1 ). 
The scrolling region and the dialog buffer size are limited to 
the size of the terminal screen (32 lines maximum). In Origin 
mode Relative, you can address any character position in 
the scrolling region relative to the upper-left character posi- 
tion of the scrolling region. If edit margins have not been 
set, then the scrolling region is the same size as the dialog 
buffer. 
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When Origin mode is Relative, the cursor 
moves with respect to the scrolling region. 
When Origin mode is Absolute, the cursor 
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Figure 4-1 . Fixed and Scrolling Regions in the Dialog Area. 
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SCREEN EDITING OPERATING 
MODES 

The terminal has two screen editing modes, Ansi mode and 
VT52 mode. You can configure the terminal to accept 
VT100 applications by operating in Edit mode, a submode 
of Ansi mode. (More on Edit mode later.) Figure 4-2 shows 
how these modes relate to one another. 

To use a screen editing program: 

• The terminal's dialog area must be visible; use the SET 
DIALOG AREA VISIBILITY command from Setup mode 
orTekmode. 

• The terminal must be in one of the screen editing modes; 
use the SELECT CODE command from any mode. 



ANSI MODE 

In Ansi mode, you can use the RM (Reset Modes) and SM 
(Set Modes) commands to change the operating character- 
istics of the terminal. For example, you can: 

• Select an 80-column width or 1 32-column width or 1 32- 
column width 

• Determine whether characters in the rightmost column 
automatically wrap to the beginning of the next line 

• Determine whether characters are inserted into an exist- 
ing line or write over existing characters 

• Reverse the colors on the display 

• Choose whether keyboard keys repeat when held down 

Although you set these characteristics while the terminal is 
in Ansi mode, they stay set when you enter any other mode. 
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Figure 4-2. Screen Editing Modes. 
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Edit Mode 

Edit mode is a submode of Ansi mode, and simply confi- 
gures the terminal automatically so that it is compatible with 
most VT1 00 software. While working in Edit mode, you are 
actually still in Ansi mode and can use all Ansi mode 
commands. 

Here's what the terminal does when it enters Edit mode: 

• Selects ANSI X3.64 syntax 

A r«nUlnn +Un .linlnn nrrto m r>1 i-J n^l!/QP it wioiKIa 

w ti laUlCD 11 IO UlCUvy ai oa ai iu 1 1 larvou n »wiwiv 

• Sets the dialog buffer to 24 lines 

• Defines the scrolling region to match the size of the dia- 
log buffer (24 lines) 

• Sets two RM and SM command modes: 

• Sets Origin mode to Absolute 

• Sets insert/Replace mode to Replace (overwrites 
rather than inserts characters) 

Finally, Edit mode temporarily disables all programmed 
keys. However, you can re-enable their programmed mean- 
ings while in Edit mode by using the ENABLE KEY EXPAN- 
SION 1 command. 



VT52 MODE 

VT52 mode configures the terminal to run most VT52 appli- 
cations programs. You can use only the VT52 mode com- 
mands listed in this section. 

VT52 mode has two submodes: Graphics mode and Alter- 
nate Keypad mode. Entering Graphics mode selects the 
Rulings characters as the GO character set; exiting Graph- 
ics mode restores the character set to the GO character set 
that was in effect prior to entering this mode. 

Entering Alternate Keypad mode gives the numeric keypad 
and Keys F5 through F8 meanings different than their fac- 
tory default or programmed meanings; exiting this mode 
restores the factory default or programmed meanings. 

If you switch back and forth between Ansi (or Edit) mode 
and VT52 mode, the numeric keypad retains its mode selec- 
tion even though the mode name changes. That is, if the 
keypad is set to send numeric codes while in Ansi mode, 
then it sends factory default meanings while in VT52 mode; 
if the keypad is set to send applications codes while in Ansi 
mode, then it sends the alternate keypad meanings in VT52 
mode. See the VT52 command description for ENTER 
ALTERNATE KEYPAD MODE. 



Ansi Mode Commands 

Ansi mode commands allow you to: 

• Position the cursor 
e Set edit margins 

• Delete characters and lines 

• Erase characters and lines 

• Insert characters and lines 

• Set the attributes of displayed characters 

• Control terminal operating characteristics 

Take a look at the list of Ansi mode commands by function 
immediately preceding their detailed descriptions. 



VT52 Mode Commands 

VT52 mode commands allow you to: 

• Position the cursor 

• Erase portions of text 

• Control functions and modes 

Cursor movement commands move the cursor up, down, 
left, and right with respect to the dialog buffer. 

Erasure commands erase portions of lines or portions of the 
screen from the current position to the end of the line or bot- 
tom of the screen. 

Some commands control functions (for example, IDEN- 
TIFY). Other commands control modes (like, ENTER 
GRAPHICS MODE). 



These are Tek mode commands and are described in the section titled 
4100-Style Parameter Types, Commands, and Reports. 
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ANSI AND VT52 MODE COMMAND 
SYNTAX 

Remember these conventions when using Ansi or VT52 
mode commands: 

• Command names are always shown in all uppercase 
characters. 

• Characters shown in bold type are those that you must 
enter exactly as shown. 

• Multiword items are joined by hyphens. For example, 
parameter-name and next-parameter-name (used in Fig- 
ure 4-3) represent single items described by two or more 
words. 

• In Host syntax, when a command has more than one 
parameter, separate them with semicolons. 

• In Setup syntax, enter parameters on the same line and 
separate them with a space or a comma. 

• Most commands take integer values for their parame- 
ters. The widest valid range is — 32767; however, if you 
specify a value higher than is reasonable for a particular 
parameter, the parameter defaults to the highest value 
that it can accept. 

• Default parameter values, if any, are shown at the end of 
each parameter description. 

Figure 4-3 illustrates this section's command description 
format. 



The appendices contain a group of command cross-refer- 
ence lists. By scanning this appendix, you can, for example, 
see all the parameter defaults for ail commands at a glance. 
You can locate the descriptive name of a command for 
which you know the Setup name. You can quickly find a 
command's opcode, or what its parameters are, or whether 
its parameters are saved in nonvolatile memory. 



COMMAND NAME 

The purpose of the command. 
Host Syntax 



E c[parameter-name; next-parameter-name Z 



Setup Syntax 



SETUPNAME parameter-name, next-parameter-name 



parameter-name: Each parameter is explained in a separate 

paragraph. 

Defaults: Omitted = Value if none specified 

next-parameter-name: The next parameter explained. 
Defaults: Omitted = Value 



Figure 4-3. Command Description Format for Ansi and VT52 
Mode Commands. 
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ANSI MODE COMMANDS GROUPED 
BY FUNCTION 

Moving the Cursor 

CUB — Cursor Backward 

CUD — Cursor Down 

CUF — Cursor Forward 

CUP — Cursor Position 

CUU — Cursor Up 

HVP — Horizontal and Vertical Position 

IND — Index 

NEL — Next Line 

Rl — Reverse Index 

TEKRC — Restore Cursor 

TEKSC — Save Cursor 

Deieting Characters and Lines 

DCH — Delete Character 

DL — Delete Line 



Working With Tabular Material 

CBT — Cursor Backward Tab 
CHT — Cursor Horizontal Tab 
HTS — Horizontal Tab Set 
TBC — Tab Clear 
h t — Horizontal Tab 
v t — Vertical Tab 



Setting Terminal Characteristics 

DMI — Disable Manual Input 

EMI — Enable Manual Input 

RIS — Reset to Initial State 

RM — Reset Modes 

SM — Set Modes 

TEKKPAM — Keypad Application Mode 

TEKKPNM — Keypad Numeric Mode 



Changing Modes 

SELECT CODE 



Erasing Characters and Lines 

ECH — Erase Character 
ED — Erase in Display 
EL — Erase in Line 



Inserting Characters and Lines 

ICH — Insert Character 
IL — Insert Line 



Choosing Display Styles 

SGR — Select Graphic Rendition 
TEKDHL — Double Height Line 
TEKDWL — Double Width Line 
TEKSWL — Single Width Line 



Scrolling the Dialog Area 

SD — Scroll Down 

SU — Scroll Up 

SL — Scroll Left 

SR — Scroll Right 

TEKSTMB — Set Top and Bottom Margins 



Control Characters 

b l Bell 

B s Backspace 

c n Cancel 

c r Carriage Return 

f f Formfeed 

l f Linefeed 

s i Shift In 

s o Shift Out 

s p Space 

_ Underscore 



Reporting to the Host 

CPR — Cursor Position Report 
DSR — Device Status Report 
DA — Device Attributes 
REPORT SYNTAX MODE 
TEKID — Identify Terminal 
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ANSI MODE COMMAND 
DESCRIPTIONS 



c n (Cancel) 

Cancels an Ansi mode command in progress. 



b l (Bell) 

Sounds the terminal's bell. 

B s (Backspace) 

Moves the cursor left one position. 

The B s character moves the cursor one character position to 
the left. If the cursor is already at Column 1 , then B s has no 
effect. 

CBT (Cursor Backward Tab) 

Moves the cursor backwards to a preceding tab stop on the 
current line. 

Host Syntax 



E c[ number-of-preceding-tab-stops Z 



number-of-preceding-tab-stops: Enter 1 to move the cursor 
to the preceding tab stop. A value greater than 1 (n) moves 
the cursor to the nth preceding tab stop on the current line. 
If there are less than n preceding tab stops, the cursor 
moves to Column 1 of the current line. 
Default: Omitted or = 1 



CHT (Cursor Horizontal Tab) 

Moves the cursor forward to a following tab stop on the 
current line. 



Host Syntax 



E c[ number-of-following-tab-stops I 



number-of-following-tab-stops: Enter 1 to move the cursor 
to the next tab stop. A value greater than 1 («) moves the 
cursor to the nth next tab stop on the current line. If there 
are less than n following tab stops, the cursor moves to the 
end of the current line. 
Default: Omitted or = 1 



CPR (Cursor Position Report) 

Provides the row and column address of the current cursor 
position. 

Host Syntax 



E c[ row ; column R 



The CPR (Cursor Position Report) message is sent from the 
terminal to the host in response to a DSR (Device Status 
Report) command with 6 for a parameter. 

If Origin mode is Relative (TEKOM set), the coordinates 
reported are row, column coordinates in the scrolling 
region. Row 1 , Column 1 is the upper-left corner of the 
scrolling region. 

If Origin mode is Absolute (TEKOM reset), the coordinates 
reported are row, column coordinates of the dialog buffer. 
Row 1 , Column 1 is the upper-left corner of the dialog buffer. 

The terminal does not enter Bypass mode for the CPR. 



c r (Carriage Return) 

Moves the cursor to the first column in the current line. 

If Carriage Return/Linefeed ( c r l f) mode is set, a linefeed 
action is also performed. 



4-8 



4107/4109 PROGRAMMERS 



SCREEN EDITING 
ANSI COMMANDS 



CUB (Cursor Backward) 

Moves the cursor ieft the specified number of coiumns. 
Host Syntax 



E c[ number-of-columns D 



number-of-columns: The number of columns to move the 
cursor toward the ieft side of the screen. The cursor does 
not move beyond Column 1 . 
Defauit: Omitted or = 1 

If Column mode is set to 1 32, the cursor may disappear 
from the screen. This command will not scroll horizontally to 
keep the cursor in view. 

CUD (Cursor Down) 

Moves the cursor down the specified number of lines. 
Host Syntax 



E c[ number-of-lines B 



number of lines: The number of lines to move the cursor 

down. 

Default: Omitted or = 1 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. 



CUF (Cursor Forward) 

Moves the cursor the specified number of columns to the 
right. 

Host Syntax 



E c[ number-of-columns C 



number-of-columns: The number of columns to move the 
cursor toward the right side of the screen. The cursor does 
noi move beyond the rightmost margin. 
Default: Omitted or = 1 

If Column mode is set to 1 32. the cursor may disappear 
from the screen. This command will not scroll horizontally to 
keep the cursor in view. 

CUP (Cursor Position) 

Moves the cursor to a specified row and column. 
Host Syntax 



E c[ row-number; column-number H 



row-number: The destination row for the cursor. 
Default: Omitted or = 1 

column-number: The destination column for the cursor. 
Default: Omitted or = 1 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. Row 1 , Column 1 is the 
upper-left corner of the scrolling region. 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. Row 1 , Column 1 is the 
upper-left corner of the dialog buffer. 
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CUU (Cursor Up) 

Moves the cursor upward the specified number of lines. 
Host Syntax 



E c[ number-of-lines A 



number-of-lines: The number of lines to move the cursor 
toward the top of the screen. 
Default: Omitted or = 1 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. 



DA (Device Attributes) 

Tells the terminal to report what type of terminal it is. 
Host Syntax 



E c[ device-status-request c 



device-status-request: This parameter is always 0. 
Default: Omitted = 

The host sends this command with a parameter of to the 
terminal asking it to identify what type of terminal it is. The 
terminal sends back to the host the report E c[?1 ;2c, which 
says that the terminal is similar to a VT1 00 with Advanced 
Video Option. This means that the terminal includes: 

• 132 Column mode 

• Bold, blink, underline, and reverse image character 
attributes 

If the host echos this report back to the terminal, the 
terminal ignores the echo. 



DCH (Delete Character) 

Deletes the character at the cursor and characters following 
the cursor depending on the value of the parameter. 

Host Syntax 



E c[ number-of-characters P 



number-of-characters: The number of characters to delete. 
Default: Omitted or = 1 

Any characters to the right of the deleted characters are 
moved left by the same number of character positions; thus 
the gap is filled and the remainder of the line to the right of 
the last character is filled with spaces. 

Only characters on the current line are affected by this 
command. 



DL (Delete Line) 

Deletes the specified number of lines starting with the 
current line. 

Host Syntax 



E c[ number-of-lines M 



number-of-lines: The number of lines to delete. 
Default: Omitted or = 1 

All lines following the deleted lines (including those in the 
invisible portion of the scroll) are shifted in a block toward 
the line containing the cursor. The cursor does not change 
position. If fixed and scrolling regions have been defined, 
this command only affects lines in the region that the cursor 
is currently in. For example, if the cursor is in the top fixed 
region, only the lines in the top fixed region are affected. 
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DM1 (Disable Manual Input) 

Disables the keyboard. 
Host Syntax 



*c* 



This command is the equivalent of the Ansi mode SM com- 
mand with the KAM parameter or of the 41 00-styie com- 
mand LOCK KEYBOARD with a parameter of 1 . 



DSR (Device Status Report) 

Generates a CPR (Cursor Position Report) or a DSR 
(Device Status Report). 

Host Syntax 



E c[ status n 



status: Determines whether the DSR is a command from the 
host or a report from the terminal (see Table 4-1 for parame- 
ter values). 

When the host sends a DSR command with a parameter of 
5, the terminal responds with a DSR message telling 
whether or not there is a malfunction. When the host sends 
a DSR command with a parameter of 6, the terminal 
responds with a CPR (see CPR command for the meaning 
of the response). If the terminal receives a DSR with a 

report it has sent to the host), the terminal ignores that DSR. 



Table 4-1 
DEVICE STATUS REPORT PARAMETERS 



Parameter 


Meaning 





Report from terminal: ready — no malfunctions 
detected 


3 


Report from terminal: malfunction — try again 


5 


Command from host: report status using a DSR 


6 


Command from host: report cursor position using a 
CPR (see CPR command) 



ECH (Erase Character) 

Erases the specified number of characters starting at the 
cursor position. 

Host Syntax 



E c[ number-of-characters X 



number-of-characters: The number of characters to erase. 
Default: Omitted or = 1 

Characters are erased, not deleted. When a character is 
erased, its character cell is cleared (replaced with the cur- 
rent erase color index). The cursor location remains 
unchanged. 

The effect of the ECH command is not confined to the cur- 
rent line. For example, if the cursor is in Column 41 , and an 
ECH command with a parameter of 45 is issued, the 45 
characters at and following the cursor position are erased. 
This is true even if this means erasing characters on follow- 
ing lines and into the fixed region from within the scrolling 
region. 



ED (Erase in Display) 

Erases part or all of the current display, according to the 
parameter. 

Host Syntax 






erase-extent: Enter to erase text from the cursor position to 
the end of the dialog buffer. Enter 1 to erase text from the 
beginning of the dialog buffer to the cursor position. Enter 2 
to erase the entire dialog buffer. 
Default: Omitted = 

The cursor does not change position. 
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EL (Erase in Line) 

Erases part or all of the current line, according to the 
parameter. 

Host Syntax 



E c[ erase-extent K 



HTS (Horizontal Tab Set) 

Sets a tab stop at the current cursor location or sets the tab 
stops for the entire screen. 

Host Syntax 



E cH 



erase-extent: Enter to erase text from the cursor position to 

the end of the line. Enter 1 to erase text from the beginning 

of the line to the cursor position. Enter 2 to erase the entire 

line. 

Default: Omitted = 



EMI (Enable Manual Input) 

Enables the keyboard. 
Host Syntax 



Setup Syntax 



E cb 



This command is the equivalent of the ANSI-style RM com- 
mand with the KAM parameter or of the 4100-style LOCK 
KEYBOARD command with a parameter of 0. 

f f (Formfeed) 

The terminal inserts f f into the dialog area and advances 
the cursor position. This character indicates the start of a 
new page to a hardcopy unit (see command description for 
Tek mode command SET DIALOG HARDCOPY 
ATTRIBUTES). 



TABS list-of-tab-stops 



list-of-tab-stops: A list of numbers representing the column 
numbers where you want tab stops set. 
Default: Factory default = 1 , 9, 1 7, 25, 33, 41 , 49, 57, 65, 
73,81,89,97,105,113,121,129. 

The tab stops that are in effect when the terminal is turned 
on are those stops that have been saved in nonvolatile 
memory. 



HVP (Horizontal and Vertical Position) 

Moves the cursor to a specified row and column of the 
screen. 

Host Syntax 



E c[ row-number ; column-number f 



row-number: The destination horizontal row number for the 

cursor. 

Default: Omitted or = 1 



h t (Horizontal Tab) 

Advances the cursor forward to the next horizontal tab stop 
on the current line. 

If there are no horizontal tab stops to the right of the cursor 
position, the cursor moves to the last column of the line. 

The tab stops that are in effect when the terminal is turned 
on are at columns: 1,9,17, 25, 33, 41 , 49, 57, 65, 73, 81 , 89, 
97, 1 05, 1 1 3, 1 21 , 1 29. These power-up tab stops can be 
changed and saved with the SAVE NONVOLATILE 
PARAMETERS command. 



column-number: The destination vertical column number 

for the cursor. 

Default: Omitted or = 1 

If Origin mode is Relative (TEKOM set), the cursor moves 
with respect to the scrolling region. The cursor does not 
move beyond the top and bottom of the scrolling region. 

If Origin mode is Absolute (TEKOM reset), the cursor moves 
with respect to the dialog buffer. "Row 1 , Column 1 " is the 
upper-left corner of the dialog buffer. The cursor does not 
move beyond the top and bottom of the dialog buffer. 
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ICH (Insert Character) 

Inserts the specified number of Space characters at the 
cursor position. 

Host Syntax 



E c[ number-of-characters t 



number-of-characters: The number of Space characters to 

insert. 

Default: Omitted or = 1 

The character currently at the cursor position and all other 
characters to the right of the cursor are shifted n columns to 
the right. Characters shifted off the end of the line are lost. 
The cursor position remains unchanged. 



IL (Insert Line) 

Inserts the specified number of blank lines in place of the 
current line. 

Host Syntax 



E c[ number-of-lines L 



number-of-lines: The number of lines to insert. 
Default: Omitted or = 1 

The current line and all following lines are shifted down. 
Lines scrolled below the bottom margin are lost. The cursor 
position does not change. 

If fixed and scrolling regions have been defined, this com- 
mand only affects lines in the region that the cursor is cur- 
rently in (if the cursor is in the scrolling (nonfixed) region, 
only the lines in the scrolling region are affected). 



IND (Index) 

Moves the cursor down one line without affecting its charac- 
ter position on the line. 

Host Syntax 



E cD 



If the cursor is on the last line of the scrolling region, a blank 



removed from the beginning of the scrolling region. The cur- 
sor can index into the scrolling region from the top fixed 
region, but cannot index into the bottom fixed region. An 
index on the last line of the bottom fixed region has no 
effect. 



i-F (Linefeed) 

Moves the cursor position down one line. 

If LNM (Linefeed/Newline mode) is reset, then l f has exactly 
the same effect as the IND (Index) command; it advances 
the cursor to the same position on the following line of text. 
If the cursor is on the last line of the scrolling region, a blank 
line is added to the end of the scrolling region and a line is 
removed from the beginning of the scrolling region. 

If LNM (Linefeed/Newline mode) is set, then l f has the same 
effect as c r IND: it advances the cursor position to the first 
character position on the following line. 



NEL (Next Line) 

Moves the cursor to the start of the next line. 
Host Syntax 



E cE 



The NEL (Next Line) command has the same effect as 
c rIND (a Carriage Return character followed by an IND 
(Index) command); the cursor moves to the first character 
position on the next line. 
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REPORT SYNTAX MODE 

Sends a Terminal Settings Report to the host. 
Host Syntax 



E c#!0 



The Terminal Settings Report contains the terminal's syntax 
mode status. 

This command has the same effect as a REPORT TERMI- 
NAL SETTINGS command issued for the SELECT CODE 

rnmmflnH (ac if E rlO%l woe coot fmm +ho h^>^+\ C^o **-i^ 

REPORT TERMINAL SETTINGS command in Section 5 for 
additional information. 

This command is recognized in all modes: Ansi, Edit, Tek, 
and VT52. 



Rl (Reverse Index) 

Moves the cursor position up one line without affecting the 
cursor position on the line. 

Host Syntax 



E cM 



If the cursor is on the first line of the scrolling region, a new 
line is added to the beginning of the scrolling region and a 
line is removed from the end of the scrolling region. 



RIS (Reset to Initial State) 

Resets certain terminal attributes to power-up condition. 
Host Syntax 



c cc 



When the terminal receives this command, it: 

• Erases the screen 

• Positions the dialog area cursor at the Home position 

• Sets Insert/Replace mode to Replace 

• Clears edit margins 

• Turns off the character graphic rendition feature 

• Selects default GO or G1 character set 

• Shifts in the GO character set 

• Enables the dialog area 

• Makes the dialog area visible 

RM (Reset Modes) 

Resets one or more terminal modes. 
Host Syntax 



E c[ mode I 



Each mode is specified by a separate parameter. You can 
reset more than one mode by stringing parameters together, 
separated by semicolons. A mode is reset until you set it 
again with the SM (Set Modes) command. 



NOTE 

If you are resetting more than one mode, put 
parameters that contain digits only first, followed 
by parameters containing special characters (? and 
<). When a? is the first character in the parameter 
list, the terminal interprets all subsequent digit-only 
parameters as also beginning with a ? character. 

Alternatively, if you 're issuing a series of parame- 
ters that all start with the ? character, you can issue 
the first parameter as a? only, followed by just the 
digit of each parameter you issue. 
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The following paragraphs describe each mode's set and 
reset condition; Table 4-2 (next page) summarizes this same 
information and gives the parameters that set and reset 
each terminal mode. 

Keyboard Action Mode (KAM). When reset, enables the 
terminal keyboard. When set, disables the terminal key- 
board. 

Insert/Replace Mode (IBM). When reset, each entered 
character overwrites (that is, replaces) the character at the 
cursor position. When set. each entered character is 
inserted at the cursor position and characters at and to the 
right of the cursor position move to the right. 

Send/Receive Mode (SRM). When reset, the terminal dis- 
plays characters as they are sent to the host (local echo). 
When set, the terminal does not echo locally. 

Linefeed/Newline Mode (LNM). When reset, l f (Linefeed) 
moves the cursor down one line without changing its 
column position. When set, l f moves the cursor to the 
beginning of the next line. 

Overstrike/FSeplace Mode. When reset, s p (Space) and 
(Underscore) are treated as normal characters. When set, 
s p advances the cursor to the next character position and 
underlines the current character. 

Cursor Keys Mode (TEKCKM). When reset, Function Keys 
F1 — F4 transmit regular ANSI cursor control commands; 
however, if these keys are programmed and key expansions 
are enabled, they transmit their programmed values. When 
set, Function Keys F1 — F4 transmit application program 
codes. Table 4-3 shows the codes that these keys transmit 
when reset and set. 

Ansi-to-VT52 Mode (TEKANM). When reset, puts the termi- 
nal in VT52 mode. Has no effect when set. 



Column Mode (TEKCOLM). When reset, specifies 80- 
column width. When set, specifies 132-column width. When 
Column mode is set to 1 32, the maximum number of visible 
lines in the dialog area is reduced from 32 to 30. 

Setting and resetting this mode erases the contents of the 
dialog area and resets margins, but does not affect Origin 
mode, tabs, character attributes, or any other screen attrib- 
utes. 

When Column mode is set to 1 32, the terminal displays only 
80 of the 1 32 columns at any time, but horizontal scrolling 
can bring any of the columns into view. If you make the dia- 
log area visible with the Dialog key, the dialog area will scroll 
automatically. That is, if the cursor is in Columns 1 — 80, the 
dialog area will scroll right to bring the leftmost column into 
view; if the cursor is in Columns 81 — 1 32, the dialog area 
will scroll left to bring the rightmost column into view. 

Screen Mode (TEKSCNM). When reset, reverses the colors 
on the display from reversed to normal, and Index in the 
dialog area changes from transparent to opaque. When set, 
reverses the colors on the display from normal to reversed, 
and Index in the dialog area returns to transparent. 

Origin Mode (TEKOM). When reset, Origin mode is Abso- 
lute; the cursor moves to Row 1 , Column 1 of the dialog 
area and the dialog buffer size is reduced to the screen size. 
When set, Origin mode is Relative and the cursor moves to 
Row 1, Column 1 of the scrolling region. 

Autowrap Mode (TEKAWM). When reset, disables auto- 
wrap so that characters entered in the rightmost column 
write over existing characters in that column. When set, 
enables autowrap so that characters entered in the right- 
most column wrap around to the next line. 

Autorepeat Mode (TEKARM). When reset, disables autore- 
peat so that keyboard keys do not repeat when held down. 
When set, enables autorepeat so that keyboard keys repeat 
when held down. 
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Table 4-2 
RM (RESET MODES) AND SM (SET MODES) COMMAND PARAMETERS 



Host 
Parameter 


Mode Name 


Result 


Setup Version 


2 


KAM (Keyboard Action mode) 


Reset: Enabled 
Set: Disabled 


LOCKKEYBOARD no 
LOCKKEYBOARD yes 


4 


IRM (Insert/ Replace mode) 


Reset: Replace 
Set: Insert 


INSERTREPLACE replace 
INSERTREPLACE insert 


12 


SRM (Send/ Receive mode) 


Reset: Enables echo 
Set: Disables echo 


ECHO yes 
ECHO no 


20 


LNM (Linefeed/ Newline mode) 


Reset: Linefeed 
Set: Newline 


LFCR no 
LFCR yes 


<1 


TEKORM (OverstriKe/ Replace 
mode) 


Reset: Overstrike 
Set: Replace 


DAMODE overstrike 
DAMODE replace 


?1 


TEKCKM (Cursor Keys mode) 


Reset: Keys F1 — F4 normal 
Set: Keys F1 — F4 application 


CURSORKEYMODE no 
CURSORKEYMODE yes 


?2 


TEKANM (Ansi-to-VT52 mode) 


Reset: VT52 mode 
Set: No effect 


CODE VT52 


?3 


TEKCOLM (Column mode) 


Reset: 80 columns 
Set: 132 columns 


COLUMNMODE 80 
COLUMNMODE132 


?5 


TEKSCNM (Screen mode) 


Reset: Normal display 
Set: Reversed display 


SCREENMODE normal 
SCREENMODE reverse 


?6 


TEKOM (Origin mode) 


Reset: Absolute 
Set: Relative 


ORIGINMODE absolute 
ORIGINMODE relative 


?7 


TEKAWM (Autowrap mode) 


Reset: Disables autowrap 
Set: Enables autowrap 


AUTOWRAP no 

AUTOWRAP yes 


?8 


TEKARM (Autorepeat mode) 


Reset: Disables autorepeat 
Set: Enable autorepeat 


AUTOREPEAT no 
AUTOREPEAT yes 



Table 4-3 
CURSOR KEY MODE CODES 



Function Key 



Codes Sent 
When Set 



Codes Sent 
When Reset 



F1 



E cOA 



E c[A 



F2 



E cOB 



E c[B 



F3 



E cOD 



E C[D 



F4 



E cOC 



E c[C 
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s b (Sub) 

Cancels an Ansi mode command in progress. 



Table 4-4 shows the parameters needed to select a particu- 
lar character set. The appendices contain tables that list the 
contents of each character set. 



SCS (Select Character Set) 

Selects default and special character sets. 
Host Syntax (to select GO) 



E c( character-set 



Host Syntax (to select G1 ) 



E c) character-set 



Setup Syntax (to select GO) 



SELECTCHARSET GO character-set 



Setup Syntax (to select G1 ) 



SELECTCHARSET G1 character-set 



character-set: The parameter from Table 4-4 that designates 
the desired character set as either the GO or G1 character 
set. 

The terminal allows you to access two different character 
sets by using the 3 i (selects the current GO character set) 
and s o (selects the current G1 character set) commands. 
First you must designate which of the eight possible charac- 
ter sets you want to use and then you can easily switch 
between them. 

When the terminal is turned on, the character set associ- 
ated with the particular keyboard is designated as the GO 
character set and also as the G 1 character set. This com- 
mand allows you to designate different GO or G1 sets. 



Table 4-4 

SCS (SELECT CHARACTER SET) 
COMMAND PARAMETERS 



Character Set 


Character Set 
Designated 


A 


United Kingdom 


B 


U.S. (ASCII) 


G 


Swedish 


K 


German 


f 


French (See note) 


• 


LysniSi ii i\oniVSy!3n 





Ruling Set 


3 


Supplementary 



NOTE 

Please use f to designate the French character set. 
These are the current standard escape sequence 
parameters. However, for compatability with pro- 
grams designed for an earlier version of the French 
character set, the terminal does accept Rasa syno- 
nym for f. 



SD (Scroll Down) 

Scrolls lines down. 
Host Syntax 



E c[ number-of-linesT 



number-of-lines: The number of lines to scroll toward the 
bottom of the screen. 
Default: Omitted or = 1 

The SD command shifts all lines in the dialog buffer down 
the specified number (n) of rows. The n lines at the bottom 
margin are roiled out of sight and n lines are rolled into view 
at the top margin. 
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SELECT CODE 

Causes the terminal to recognize Ansi, Tek, or VT52 mode 
command syntax. Also used to select Edit mode. 

Host Syntax 



E c%! syntax 



Setup Syntax 



CODE syntax 



syntax: The mode in which you want to operate. An integer 
in Host syntax or a keyword in Setup syntax: 
Host Setup 

TEK Selects Tek mode 

1 ANSI Selects Ansi mode 

2 EDIT Selects Edit mode 

3 VT52 Selects VT52 mode 
Default: Omitted = Tek mode 

The syntax of Tek, Ansi, and VT52 mode commands are not 
compatible. If you are using commands from one mode and 
want to execute one or more commands from another 
mode, you must issue the Select Code command with the 
appropriate parameter. 

This command is recognized in all major modes: Ansi, 
Setup, Tek, and VT52. 

See the beginning of this section for an explanation of Edit 
mode. 



SGR (Select Graphic Rendition) 

Invokes the character display style specified by the 
parameters. 

Host Syntax 



E c[ graphic-rendition m 



Setup Syntax 



TEXTRENDITION graphic-rendition 



graphic-rendition: The style in which text is displayed in the 
dialog area. 
Default: Omitted = 

In Host syntax, you can set more than one display attribute 
by entering more than one parameter separated by semico- 
lons. In Setup mode, parameters must be separated by one 
or more spaces. If you are entering more than one parame- 
ter, any parameters that begin with ?, <, = , or > should be 
at the start of the list of parameters. Refer to Table 4-5 for an 
explanation of these parameters. All characters after you 
send the SGR command are displayed as specified by the 
SGR parameters until you execute another SGR command. 

In Table 4-5, foreground index is the color index of the char- 
acters as they are displayed on the screen. Background 
index is the color of the screen on which the characters are 
displayed. Erase index is the color with which the characters 
are erased when a delete or erase command is issued. 
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Table 4-5 

SGR (SELECT GRAPHIC RENDITION) 
COMMAND PARAMETERS 



Parameter 


Description 





Characters displayed in specified color indices with 
all other attributes (blink, bold, underscore, reverse) 
turned off. 


1 


Bold or increased intensity. Bold text is displayed in 



24 
25 
27 
30 
31 



Color Index 2. Color Index 2 defaults to red. 
Character background remains the same as current 
background index. 



Underscore text. 



Slow blink (less than 150 blinks per minute). 



Reverse video text. Foreground and background 
color indices are swapped. 



No underscore. Cancels the effect of SGR with 
graphic-rendition set to 4. 



No blink. Cancels the effect of SGR with 
graphic-rendition set to 5. 



Positive video text. Cancels the effect of SGR with 
graphic-rendition set to 7. 



Black display. Sets current character color index to 
0, which defaults to black. 



Red display. Sets current character color index to 2, 





which aerauns xo rea. 


32 


Green display. Sets current character color index to 
3, which defaults to green. 


33 


Yellow display. Sets current character color index to 
7, which defaults to yellow. 


34 


Blue display. Sets current character color index to 4, 
which defaults to blue. 


35 


Magenta display. Sets current character color index 
to 6, which defaults to magenta. 


36 


Cyan display. Sets current character color index to 5, 
which defaults to cyan. 


37 


White display. Sets current character color index to 
1 , which defaults to white. 


39 


Default display color, Color Index 1 , which defaults 
to white. 



Table 4-5 (cont) 

SGR (SELECT GRAPHIC RENDITION) 
COMMAND PARAMETERS 



Parameter 



40 



41 



42 



43 



44 



45 



46 



47 



49 



< index 



= index 



> index 



Description 



Transparent background. Sets current character 
background color index to 0, which defaults to 
transparent. 



Red background. Sets current character 
background color index to 2, which defaults to red. 



Green Background. Sets current character 
background color index to 3 which defaults 
green. 



Yellow background. Sets current character 
background color index to 7, which defaults to 
yellow. 



Blue background. Sets current character 
background color index to 4, which defaults to blue. 



Magenta background. Sets current character 
background coior index to 6, which defaults to 
magenta. 



Cyan background. Sets current character 
background color index to 5, which defaults to cyan. 



White background. Sets current character 
background color index to 1 , which defaults to white. 



Default background color, Color Index 0, which 
defaults to transparent. 



Character color. Parameter specifies the color index. 
Indices from to 7 select colors in the terminal's 
color map. Indices greater than 7 default to 7. 



Background color. Parameter specifies the 
character background color index. Index means 
that the graphics area shows through. Background 
indices from 1 to 7 represent colors in the terminal's 
color map. Indices greater than 7 default to 7. 



Erase color. Parameter specifies the dialog area 
erase color index. Erase Index always means that 
the graphics area shows through. Indices from 1 to 7 
select colors in the terminal's color map. Indices 
greater than 7 default to 7. 
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Si (Shift In) 

Invokes the current GO character set. 

The terminal allows you to access two different character 
sets by using the s i (selects the current GO character set) 
and s o (selects the current G1 character set) commands. 

The s i command invokes the current GO character set 
installed in the terminal. This may be the 94 graphic charac- 
ters from the ASCII character set, or the corresponding 94 
characters from the United Kingdom, French, Swedish, 
Danish/Norwegian, German, supplementary, or special rul- 
ings character sets; each of these character sets is desig- 
nated by connecting a standard or optional keyboard to the 
terminal or by using the SCS (Select Cnaracter Set) com- 
mand. Appendix A of this manual lists these character sets. 

To select the G1 character set, use the s o (Shift Out) 
character. 

SL (Scroll Left) 

Moves the contents of the visible dialog area to the left. 
Host Syntax 



E c[ number-of-columns s p(i 



number-of-columns: Specifies the number of columns to 

scroll left. 

Default: Omitted or = 1 

The SL command moves the entire contents of the visible 
dialog area to the left by the specified number of columns. 
You can scroll horizontally only when Column mode is set to 
1 32. Since the cursor moves with the text, the cursor may 
disappear from the screen. Unlike vertical scrolling, the ter- 
minal will not automatically scroll left or right to keep the 
cursor in view. 

To scroll horizontally, you must give the SCROLL LEFT or 
SCROLL RIGHT command (or you can use the joydisk). 
However, an automatic scroll left may occur when you make 
the dialog area visible with the DIALOG key; if the cursor is 
in Columns 81 — 1 32, the terminal will scroll left to bring the 
rightmost column into view. 



SM (Set Modes) 

Sets one or more modes. 
Host Syntax 



E c[ mode h 



mode: The terminal mode or modes that you want to set. 
Default: Omitted = (not a valid parameter) 

Each mode to be set is specified by a separate parameter. 
You can set one or more modes by entering more than one 
parameter separated by semicolons. A mode remains set 
until you reset it with an RM (Reset Mode) command. Refer 
back to the RM command description for an explanation of 
the mode parameters. 



s (Shift Out) 

Invokes the G1 character set. 

The terminal allows you to access two different character 
sets by using the s i (selects the current GO character set) 
and s o (selects the G1 character set) commands. 

The s o command invokes the the G1 character set. When a 
keyboard is plugged into the terminal, the character set 
associated with that keyboard is designated as both the GO 
and the G1 set. You may use the SCS (Select Character Set) 
command to designate a different character set than the 
one associated with the current keyboard. Appendix A lists 
the contents of all the available character sets. 

To select the GO character set, use the s i (Shift In) character. 
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s p (Space) 

Moves the cursor one character position to the right or 
inserts a s p (Space) character. 

if Overstrike mode is enabled (TEKORM is reset), s p moves 
the cursor one character to the right. The s p character does 
not replace the character, if any, at the cursor position. 

If Replace mode is enabled (TEKORM is set), s p replaces 
any character at the cursor position. 



SU (Scroll Up) 

Scrolls lines up. 
Host Syntax 



E c[ number-of-lines S 



number-of-lines: The number of lines to scroll toward the 
top of the screen. 



SR (Scroll Right) 

Moves the contents of the visibie dialog area to the right. 
Host Syntax 



E cf numher-of-columns s p A 



number-of-columns: Specifies the number of columns to 

scroll right. 

Default: Omitted or = 1 

The SR command moves the entire contents of the visible 
dialog area to the right by the specified number of columns. 
Since the cursor moves with the text, the cursor may disap- 
pear from the screen. Unlike vertical scrolling, the terminal 
will not automatically scroll left or right to keep the cursor in 
view. 

To scroll horizontally, you must give the SCROLL LEFT or 
SCROLL RIGHT command (or you can use the joydisk). 
However, an automatic scroll right may occur when you 
make the dialog area visible with the DIALOG key; if the cur- 
sor is in Columns 1 — 80, the terminal will scroll right to 
bring the rightmost column into view. 



The SU (Scroll Up) command shifts all lines in the dialog 
buffer upward by the specified number («) of rows. The n 
lines at the top margin are rolled out of sight and n lines are 
rolled into view at the bottom margin. 

TBC (Tab Clear) 

Clears one or more tab stops. 
Host Syntax 



E c[ tab-clear-extent g 



tab-clear-extent: Clears the tabs as indicated by the param- 
eter values. Refer to Table 4-6 for an explanation of these 
parameters. 
Default: Omitted = 



Table 4-6 
TBC (TAB CLEAR) COMMAND PARAMETERS 



Parameter 


Description 





Clears the horizontal tab stop at the cursor position 


2 


Clears all horizontal tab stops 


3 


Clears all horizontal tab stops 
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TEKDHL (Double Height Line) 

Causes the line containing the cursor to become the top or 
bottom half of a double-height, double-width line. 

Host Syntax 



Top Half Bottom Half 

E c#3 E c#4 



Both lines that receive these commands must contain the 
same characters. Since using double-width characters 
halves the number of characters per line, characters to the 
right of screen center are lost if the iine was previously sin- 
gle width. 

If the terminal receives the Bottom Half command without 
receiving the Top Half command first, the line will be double- 
width and single height. 

To make an exact hardcopy of a double-height, double- 
width line, you must make a screen copy. Making a dialog 
copy will copy each character of the top-half line as a regu- 
lar size character followed by a space; the bottom-half line 
becomes a blank line. (See the Tek mode HARDCOPY com- 
mand description for additional details about making screen 
and dialog copies.) 

This command affects only the current line. The line will 
retain this attribute until the line is deleted or until the termi- 
nal receives another line attribute command (TEKDHL, 
TEKDWL.orTEKSWL). 



TEKDWL (Double Width Line) 

Causes the line containing the cursor to become a double- 
width, single-height line. 



Host Syntax 




This command affects only the current line. The line will 
retain this attribute until the line is deleted or until the termi- 
nal receives another line attribute command (TEKDHL, 
TEKDWL.orTEKSWL). 

Since using double-width characters halves the number of 
characters available per line, characters to the right of 
screen center are lost if the line was previously single width. 

To make an exact copy of a double-width line, you must 
make a screen copy. Making a dialog copy will copy each 
character in the line as a regular size character followed by 
a space. (See the Tek mode HARDCOPY command 
description for additional details about making screen and 
dialog copies.) 



TEKID (Identify Terminal) 

Tells the terminal to report what type of terminal it is. 
Host Syntax 



E cZ 



This command causes the same response as the Ansi mode 
DEVICE ATTRIBUTES (DA) command with a parameter 
ofO. 



NOTE 

The TEKID command is provided in Ansi mode 
only for compatibility with programs written for 
VT100 terminals. Avoid using this command if you 
can; its use violates ANSI and ISO standards. 



4-22 



4107/4109 PROGRAMMERS 



SCREEN EDITING 
ANSI COMMANDS 



TEKKPAM (Keypad Application Mode) 

Places the terminal in Keypad Application mode. 
Host Syntax 



Setup Syntax 



i/p\/nA 



t/nii nunnc itnni i/^atiaw 
i rnvmui/t nrruvni iwn 



The TEKKPAM command causes the numeric keypad to 
send characters distinct from the numeric keys on the main 
keyboard. This means that when you press the 6 key on the 
numeric keypad, a different code is generated than when 
you press the 6 key on the main keyboard. Refer to Table 
4-/ ior an explanation of h iese cooes. 

When the terminal is turned on, it is in Keypad Numeric 
mode. 



TEKKPNM (Keypad Numeric Mode) 

Places the terminal in Keypad Numeric mode. 
Host Syntax 



c c> 



Setup Syntax 



KEYPADMODE NUMERIC 



This command causes the keys on the numeric keypad and 
function keys F5 through F8 to return to their default mean- 
ings, as shown in the righthand column of Table 4-7. !f the 
keys have been programmed and key expansions are 
enabled, the keys transmit their programmed meanings 
instead. 

When the terminal is turned on, it is Keypad Numeric mode 
(keys produce their default meanings). 



Table 4-7 
NUMERIC KEYPAD PROGRAMMING CODES 



Numeric 
Keypad Key 


Characters Sent in 
Application Mode 


Characters Sent in 

Numeric Mode 





E cOp 





1 


E cOq 


1 


2 


E cOr 


2 


3 


E cOs 


3 


4 


E cOt 


4 


5 


E cOu 


5 


6 


E cOv 


6 


7 


E cOw 


7 


8 


E cOx 


8 


q 


E cOy 


g 


- 


E cOm 


- 


» 


E cOI 


» 


1 E cOn 


ENTER 


E cOM 


C B 


F5 


E cOP 


E cOP 


F6 


E cOQ 


E cOQ 


F7 


^OR 


E cOR 


F8 


E cOS 


E cOS 



TEKRC (Restore Cursor) 

Restores the cursor position, graphic rendition, character 
set, and Origin mode previously saved using the TEKSC 
(Save Cursor) command. 

Host Syntax 



E c8 



If the TEKSC (Save Cursor) command is not used first, then 
TEKRC (Restore Cursor) returns the cursor to the Home 
position and restores the power-up graphic rendition, char- 
acter set, and Origin mode. 
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TEKSC (Save Cursor) 

Saves the cursor position, graphic rendition, character set, 
and Origin mode. 

Host Syntax 



E c7 



The TEKSC (Save Cursor) command saves information 
about the cursor position, graphic rendition, character set, 
and Origin mode in the terminal's memory. This saved infor- 
mation may be restored using the TEKRC (Restore Cursor) 
command. 



TEKSWL (Single Width Line) 

Causes the line containing the cursor to become a single- 
width, single-height line. 

Host Syntax 



E c#5 



The cursor retains its current column number. This is the 
default for all new lines in the dialog area. This command 
affects only the current line. The line will retain this attribute 
until the line is deleted or until the terminal receives another 
iine attribute command (TEKDHL, TEKDWL, or TEKSWL). 



TEKSTBM (Set Top and Bottom Margins) 

Sets the dialog buffer's edit margins. 
Host Syntax 



E c[ top-margin ; bottom-margin r 



Setup Syntax 



EDITMARGIN top-margin, bottom-margin 



top-margin: The row number of the top margin. 
Default: Omitted or = 1 

bottom-margin: The row number of the bottom margin. 
Default: Omitted or = The number of lines visible in the 
dialog buffer (DALINES). 

The parameter value for the top margin specifies which row 
of the dialog buffer becomes the top line of the scrolling 
region. Similarly, the value for the bottom margin specifies 
the row of the dialog buffer for the bottom line of the 
scrolling region. 

The rows in the dialog buffer above the top margin and the 
rows below the bottom margin become fixed regions. No 
scrolling actions occur in the fixed regions. 



v t (Vertical Tab) 

The v t character moves the cursor down one line without 
affecting the cursor position on the line. 



_ (Underscore) 

If Overstrike mode is enabled (TEKORM is reset), the cur- 
rent character is underlined and the cursor advances to the 
next character. 

If Replace mode is enabled (TEKORM is set), the under- 
score character replaces the current character. 
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VT52 COMMAND DESCRIPTIONS 

The VT52 commands that follow can be executed only whiie 
the terminal is in VT52 mode. You can put the terminal in 
VT52 mode by: 

• Entering CODE VT52 while in Setup mode 

• Sending an RM command ( E c[?2l) from the host while in 
Ansi mode 

• Sending a SELECT CODE command ( E c%!3) from the 
host while in Tek or Ansi mode 

Once the terminal is in VT52 mode, it will recognize only 
VT52 commands (which are explained here), and the com- 
mands SELECT CODE and REPORT SYNTAX MODE, both 
of which work in all modes. 



CURSOR RIGHT 

Moves the cursor one column to the right. 
Host Syntax 



E cC 



The cursor does not move beyond the rightmost column. If 
Column mode is set to 132, the cursor may disappear from 
the screen. This command will not scroll horizontally to 
keep the cursor in view. 

This command works just like the Ansi mode command 
CUF (Cursor Forward) with a parameter of 1 . 



CURSOR DOWN 

Moves the cursor down one iine without moving it 
horizontally. 

Host Syntax 



E cB 



The cursor moves with respect to the dialog buffer and 
stops at the last row of the dialog buffer. However, if margins 
are set and the cursor is within the scrolling region, the cur- 
sor stops at the bottom margin of the scrolling region. 

CURSOR LEFT 

Moves the cursor one column to the left. 
Host Syntax 



E cD 



The cursor does not move beyond the leftmost column 
(Column 1). 

This command works just like the Ansi mode command 
CUB (Cursor Backward) with a parameter of 1 . 



CURSOR TO HOME 



mqwqs thg cursor to the Home n ositlon. 



Host Syntax 



E cH 



The home position is Row 1 , Column 1 of the dialog buffer. 

CURSOR UP 

Moves the cursor up one line without moving it horizontally. 
Host Syntax 



E cA 



The cursor moves with respect to the dialog buffer and 
stops at the first row of the dialog buffer. However, if margins 
are set and the cursor is within the scrolling region, the cur- 
sor stops at the top margin of the scrolling region. 
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DIRECT CURSOR ADDRESS 

Moves the cursor to the specified line and column. 
Host Syntax 



E cY line; column 



line: An ASCII character that represents the line position 
number plus 31 . The maximum line range is 96, even if the 
dialog buffer is larger. 

column: An ASCII character that represents the column 
number plus 31 . The maximum column range is 80, even if 

WUIUIIIIt IKUOOIDOCI IU iO£-. 

For example, to move the cursor to Line 3, Column 1 , give 
the command E cY" s p since the decimal equivalent of " is 34 
(3 + 31) and the decimal equivalent of s p is 32(1 + 31). If a 
parameter is out of range, the cursor will not change posi- 
tion for that parameter. However, the cursor will move to the 
other parameter position if it is within the range. 



ENTER ALTERNATE KEYPAD MODE 

Causes the numeric keypad keys and Function Keys F5 - 
F8 to assume their Alternate Keypad mode meanings 
(shown in Table 4-8). 

Host Syntax 



Er = 



Any other meanings you program into these keys cannot be 
used as long as the terminal is in Alternate Keypad mode. 

This command works like the Ansi mode command 
TEKKPAM (Keypad Application Mode). 



Table 4-8 
ALTERNATE KEYPAD PROGRAMMING CODES 



Numeric 

Keypad 

Key 


Characters Sent 
as Factory 
Default 


Characters Sent 
in Alternate 
Keypad Mode 








E c?p 


1 


1 


E c?q 


2 


2 


E c?r 


3 


3 


E c?s 


4 


4 


E c?t 


5 


5 


E c?u 


6 


6 


E c?v 


7 


7 


E C?W 


8 


8 


E c?x 


9 


9 


E c?y 


- 


- 


E c?rn 


, 


» 


E c?l 






E c?n 


ENTER 


C R 


E C?M 


F5 


E cP 


E cP 


F6 


E cQ 


E cQ 


F7 


E cR 


E cR 


F8 


E cS 


E cS 



ENTER ANSI MODE 

Places the terminal in Ansi mode. 
Host Syntax 



c c< 



The terminal will interpret all subsequent commands 
according to ANSI Standard X3.64. 
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ENTER GRAPHICS MODE 

Causes the Rulings character set to be selected as the GO 
character set. 

Host Syntax 



E cF 



The terminal will remain in Graphics mode until you issue 
an EXIT GRAPHICS MODE command. If you issue the 
ENTER ANSI MODE command while the terminal is still in 
Graphics mode, the terminal will exit Graphics mode before 
it exits VT52 mode. 



ERASE TO END OF LINE 

Erases all characters from the cursor to the end of the 
current line. 



Host Syntax 



E cK 



The cursor position does not change. 

This command works like the Ansi mode command EL 
(Erase in Line) with a parameter of 0. 



ERASE TO END OF SCREEN 

Erases all characters from the cursor to the end of the 
screen. 



Host Syntax 



E cJ 



EXIT ALTERNATE KEYPAD MODE 

Causes the numeric keypad keys and Function Keys 

F5 — F8 to assume their factory default meanings, or their 

programmed meanings if they have been programmed. 

Host Syntax 



c c> 



Factory default meanings are shown in Table 4-8 (under 
ENTER ALTERNATE KEYPAD MODE). 

This command works like the Ansi mode command 
TEKKPNM (Keypad Numeric Mode). 

EXIT GRAPHICS MODE 

Restores the o0 character set t« iat was in effect ueiors the 
current ENTER GRAPHICS MODE command was issued. 

Host Syntax 



E cG 



IDENTIFY 

Identifies the terminal to the host. 
Host Syntax 



E cZ 



When the host issues this command, the terminal sends its 
identifier escape sequence E c/Z to the host. 



The cursor position does not change. 

This command works like the Ansi mode command ED 
(Erase in Display) with a parameter of 0. It erases text from 
the cursor position to the end of the dialog buffer, so it 

makes no difference if margins are set. 
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REPORT SYNTAX MODE 

Sends a Terminal Settings Report that contains the syntax 
mode status to the host. 

Host Syntax 



E c#!0 



This command has the same effect as a REPORT TERMI- 
NAL SETTINGS command issued for the SELECT CODE 
command (as if E clQ%! were sent from the host). See the 
REPORT TERMINAL SETTINGS command in Section 5 for 
additional information. 

This command is recognized in all modes: Ansi, Edit, Tek, 
and VT52. 



REVERSE LINEFEED 

Moves the cursor up one line without affecting the cursor 
position on the line. 

Host Syntax 



E cl 



SELECT CODE 

Causes the terminal to recognize Ansi, Tek, or VT52 mode 
command syntax. Also used to select Edit mode. 

Host Syntax 



E c%! syntax 



Setup Syntax 



CODE syntax 






TEK 


1 


ANSI 


2 


EDIT 


3 


VT52 



syntax: The mode in which you want to operate. An integer 
in Host syntax or a keyword in Setup syntax: 
Host Setup 

Selects Tek mode 

Selects Ansi mode 

Selects Edit mode 

Selects VT52 mode 
Default: Omitted = Tek mode 

The syntax of Tek, Ansi, and VT52 mode commands are not 
compatible. If you are using commands from one mode and 
want to execute one or more commands from another 
mode, you must issue the Select Code command with the 
appropriate parameter. 

Edit mode allows the terminal to be used with VT1 00 appli- 
cation programs. See the discussion of Edit mode at the 
beginning of this section. 

This command is recognized in all major modes: Ansi, 
Setup, Tek, and VT52. 
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CONTROLLING THE DISPLAY 

4010 HARDCOPY 

CRLF 

ENABLE DIALOG AREA 

HARDCOPY 

LFCR 

PAGE 

RENEW VIEW 

SET ECHO 

SET ERROR THRESHOLD 

SET FIXUP LEVEL 

SET GRAPHICS AREA WRITING 

MODE 
SET SNOOPY MODE 
SET TAB STOPS 

DIALOG AREA 

CLEAR DIALOG SCROLL 
ENABLE DIALOG AREA 
SET DIALOG AREA BUFFER SIZE 
SET DIALOG AREA COLOR MAP 
SET DIALOG AREA INDEX 

PC r>! * I or? *C»P* < "^ C S 

SET DIALOG AREA VISIBILITY 
SET DIALOG AREA WRITING MODE 
SET DIALOG HARDCOPY 
ATTRIBUTES 

GENERAL TERMINAL 
CONTROL 

CANCEL 

FACTORY 

HELP 

IGNORE DELETES 

LOCAL 

MACRO STATUS 

RESET 

SET EDIT CHARACTERS 

STATUS 

GIN (GRAPHIC INPUT) 

Enabling and Disabling GIN 

DISABLE GIN 
ENABLE 4010 GIN 
ENABLE GIN 
REPORT GIN POINT 

Setting GIN Parameters 

SET GIN AREA 

SET GIN CURSOR 

SET GIN CURSOR COLOR 

SET GIN DISPLAY START POINT 

SETGINGRIDDING 

SET GIN INKING 

SET GIN RUBBERBANDING 

SET GIN STROKE FILTERING 

SET GIN WINDOW 

SET PICK APERTURE 

Setting Parameters for GIN 
Reports 

SET REPORT EOM FREQUENCY 
SET REPORT MAX LINE LENGTH 
SET REPORT SIG CHARACTERS 

GRAPHICS COLORS 

SET BACKGROUND COLOR 

SET BACKGROUND INDICES 

SET COLOR MODE 

SET LINE INDEX 

SET SURFACE COLOR MAP 

SET TEXT INDEX 



GRAPHICS PRIMITIVES AND 
PRIMITIVE ATTRIBUTES 

Alphatext 

ENTER ALPHA MODE 

SET ALPHA CURSOR INDICES 

SET ALPHATEXT FONT 

SET TEXT INDEX 

SET 4014 ALPHATEXT SIZE 

Graphtext 

GRAPHIC TEXT 
SET CHARACTER PATH 
SET GRAPHTEXT FONT 
SET GRAPHTEXT FONT GRID 
SET GRAPHTEXT PRECISION 
SET GRAPHTEXT ROTATION 
SET GRAPHTEXT SIZE 
SET GRAPHTEXT SLANT 
SET TEXT INDEX 

Lines 

DRAW 

ENTER VECTOR MODE 

MOVE 

SET 4014 LINE STYLE 

SET LINE INDEX 

SET LINE STYLE 

Markers 

DRAW MARKER 
ENTER MARKER MODE 
SET MARKER TYPE 

Other Graphics Primitives 

INCLUDE COPY OF SEGMENT 
SET GRAPHICS AREA WRITING 

MODE 
SET PICK ID 

Panels 

BEGIN PANEL BOUNDARY 

END PANEL 

SELECT FILL PATTERN 

GRAPHTEXT 

Defining Graphtext Characters 

BEGIN GRAPHTEXT CHARACTER 
DELETE GRAPHTEXT CHARACTER 
END GRAPHTEXT CHARACTER 

SET GRAPHTEXT FONT GRID 

Displaying Graphtext 

GRAPHIC TEXT 
SET GRAPHTEXT FONT 
SET GRAPHTEXT PRECISION 
SET GRAPHTEXT ROTATION 
SET GRAPHTEXT SIZE 
SET GRAPHTEXT SLANT 

HARDCOPIES 

COPY 

HARDCOPY 

SELECT HARDCOPY INTERFACE 

SET COPY SIZE 

SET DIALOG HARDCOPY 

ATTRIBUTES 

4010 HARDCOPY 

HOST PORT 
COMMUNICATIONS 

COPY 

ENTER BYPASS MODE 



IGNORE DELETES 

PROMPT MODE 

SET BAUD RATES 

SET BREAK TIME 

SET BYPASS CANCEL CHARACTER 

SET EOF STRING 

SET EOL STRING 

SET EOM CHARACTERS 

SET FLAGGING MODE 

SET PARITY 

SET PROMPT STRING 

SET QUEUE SIZE 

SET REPORT MAX LINE LENGTH 

SET STOP BITS 

SET TRANSMIT DELAY 

SET TRANSMIT RATE LIMIT 

KEYBOARD CONTROL AND 
MACRO DEFINITIONS 

DEFINE MACRO 

EXPAND MACRO 

LEARN/NVLEARN 

LOCKKEYBOARD_ 

LOCK ViE'iVit^G Kc YS 

MACRO STATUS 

SET KEY EXECUTE CHARACTER 

SET TAB STOPS 

MODE SWITCHING 

ENTER ALPHA MODE 
ENTER BYPASS MODE 
ENTER MARKER MODE 
ENTER VECTOR MODE 
SELECT CODE 

MULTIPLE VIEWS 
Controlling a Viewports Border 

SET BORDER VISIBILITY 

Defining and Selecting Views 

DELETE VIEW 

RENEW VIEW 

SELECT VIEW 

SET VIEW ATTRIBUTES 

SET VIEW DISPLAY CLUSTER 

SET VIEWPORT 

SET WINDOW 

Zoom and Pan Operations 

LOCK VIEWING KEYS 

SET WINDOW 

NON-GIN REPORTS 
Requesting Non-GIN Reports 

REPORT 4010 STATUS 
REPORT DEVICE STATUS 
REPORT ERRORS 
REPORT PORT STATUS 
REPORT SEGMENT STATUS 
REPORT SYNTAX MODE 
REPORT TERMINAL SETTINGS 

Setting Parameters for Non-GIN 
Reports 

SET REPORT EOM FREQUENCY 
SET REPORT MAX LINE LENGTH 
SET REPORT SIG CHARACTERS 

PANELS 

Drawing Panels 

BEGIN PANEL BOUNDARY 

END PANEL 

SELECT FILL PATTERN 



PERIPHERAL DEVICES 
Two-Port Peripheral Interface 

MAP INDEX TO PEN 

PLOT 

PORT ASSIGN 

REPORT PORT STATUS 

SET PORT BAUD RATE 

SET PORT EOF STRING 

SET PORT FLAGGING MODE 

SET PORT PARITY 

SET PORT STOP BITS 



PIXEL OPERATIONS 
Data Transfer 

PIXEL COPY 
RASTER WRITE 
RECTANGLE FILL 
RUNLENGTH WRITE 

Initialization 

BP131M dixel OPERATIONS 
SET PIXEL BEAM POSITION 
SET PIXEL VIEWPORT 

SEGMENTS 
Defining Segments 

BEGIN HIGHER SEGMENT 

BEGIN LOWER SEGMENT 

BEGIN NEW SEGMENT 

BEGIN SEGMENT 

DELETE SEGMENT 

END SEGMENT 

INCLUDE COPY OF SEGMENT 

RENAME SEGMENT 

SET PIVOT POINT 

Displaying Segments 

SET FIXUP LEVEL 

Reporting Segment Settings to 
the Host 

REPORT SEGMENT STATUS 

Segment Classes 

SET CURRENT MATCHING CLASS 
SET SEGMENT CLASS 

Setting Segment Attributes 

SET SEGMENT CLASS 
SET SEGMENT DETECTABILITY 
SET SEGMENT DISPLAY PRIORITY 
SET SEGMENT HIGHLIGHTING 
SET SEGMENT IMAGE 

TRANSFORM 
SET SEGMENT POSITION 
SET SEGMENT VISIBILITY 
SET SEGMENT WRITING MODE 

SURFACES 

SET BACKGROUND COLOR 
SET BACKGROUND INDICES 
SET SURFACE COLOR MAP 
SET SURFACE DEFINITIONS 
SET SURFACE PRIORITIES 
SET SURFACE VISIBILITY 
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Section 5 

4100-STYLE PARAMETER TYPES, COMMANDS, 

AND REPORTS 



INTRODUCTION 

This section contains detailed descriptions of the terminal's 
41 00-style parameter types, commands, and reports. The 
explanations are for both the terminal's Host syntax and 
Setup mode syntax. 

The terminal executes 41 00-style commands when it is in 
Tek mode, which you specify with the SELECT CODE 
command. 

The first part of this section includes descriptions of param- 
eter types associated with 41 00-style commands. The 
parameter types are explained in alphabetical order. Com- 
mands issued from the host use special encoding for 
parameter values. Setup mode commands use simple 
English words or numbers as parameters. 

The second part of this section contains explanations of 
41 00-style commands and of reports associated with cer- 
tain commands. Most commands have two forms: one used 
for sending the command from the host, and the other used 
locally in the terminal's Setup mode. Since the host form is 
in a cryptic opcode format, it is given a descriptive command 
name to clarify what the command does. The associated 
Setup mode command accomplishes the same function 
locally; it has an English-style name that identifies the com- 
mand's purpose. The command explanations are given 
alphabetically according to the descriptive command name. 



4100-STYLE PARAMETER TYPES 

The following explanations document the various types of 
values used for the 41 00-style parameters. 

Character Array Parameters in Host Syntax 

The character array parameter type allows you to send a list 
of characters as one parameter. This parameter type occurs 
only in the host syntax form of a command. 

The first character in the array is an encoded integer indica- 
ting the length of the array. The integer is followed by the 
ASCII characters in the array. 



The following example shows how the phrase PRESS 
RETURN KEY would be sent as a character array: 

AOPRESS RETURN KEY 



Character Parameters in Setup Syntax 

The Setup mode form of commands have three kinds of 
character parameters: small integer, string, and character. 

The Small Integer Parameter. Small integer parameters 
range from through 1 27, which is the range of ASCII deci- 
mal equivalents for characters N u through d t. When you 
specify a small integer parameter, you can use either the 
actual character or its ADE value. 

The String Parameter. Some commands use an undelimi- 
ted string. The word "undelimited" means that the parame- 
ter does not require special characters to distinguish it from 
other character strings. A string parameter requires that you 
specify actual characters rather than ADE values, and that 
you not use a comma or a space in the string. 

The Character Parameter. The character parameter type 
corresponds to the printing characters listed on a standard 
ASCII chart. A character parameter has a range of s p to - 
(tilde); it has an ASCII decimal equivalent (ADE) range of 32 
to 1 26. When you specify a character parameter, you can 
use either the actual character or its ADE value. 

All three of these parameter types can be used as delimited 
parameters. When parameters are delimited, the first and 
last characters have a special meaning to distinguish that 
group of characters from others. A delimited parameter can 
only include ASCII characters, not ADE values. 

For example, in the Setup syntax of the SET EOF STRING 
command, you specify up to ten small integer characters to 
indicate the end-of-file marker. The delimiter can be any 
character (except a comma, a space, or an edit character), 
and is always the first character after the space following 
the command name. The delimiter is followed by up to ten 
alphanumeric characters and that group of characters is 
terminated by the same delimiter. The following command 
illustrates a delimited character parameter: 

EOFSTRING 'THE END' 
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Key Specifiers in Setup Syntax 

The key specifier parameter type is used in the DEFINE 
MACRO and DEFINE NONVOLATILE MACRO commands. 

See Table 5-2 (under DEFINE MACRO) for the ASCII deci- 
mal equivalents (ADE) and macro numbers referred to in the 
following paragraphs. 

Key specifiers for keys labeled with ASCII characters can be 
the ASCII character itself or a two- or three-digit ADE value 
or a macro integer number. 

Function keys are represented by macro numbers or by a 
two-character abbreviation. The abbreviations F1 through 
F8 designate the unshifted versions of the function keys; S1 
through S8 specify the shifted versions of those keys. The 
Ctrl and Shift-Ctrl versions of those keys are specified by 
macro numbers only. 

The numeric keypad, special function keys, and joydisk are 
specified by macro numbers. 



Keywords in Setup Syntax 

The keyword parameter type is used in Setup mode only. 
Keyword parameters specify what action you want a com- 
mand to perform. When you use a keyword, you can spell 
out the entire word or just as many characters as necessary 
to distinguish that keyword from other keywords associated 
with the command. 



Integer Parameters in Host Syntax 

In Host syntax, integers are encoded as a series of one, two, 
or three characters. For example, Figure 5-1 illustrates how 
that the integer -2413 is encoded as: 

BV- 

First, the decimal numeral must be translated into binary. 
Then the digits of the binary numeral are encoded (see 
Figure 5-1). 

Hi-I: There may be one or two Hi-I characters, depend- 
ing on the value of the integer. The Hi-I characters 
are: 

1 d d d d d d 

The first bit is always set to 1 ; the next six bits are 
the next six most significant bits in the binary 
numeral. In the example in Figure 5-1 , the Hi-I 
character is: 

10 10 

This corresponds to the B character on an ASCII 
chart. 

The second Hi-I character is: 

10 10 110 

This corresponds to the V character on an ASCII 
chart. 



Decimal -2413 
















= binary 00010 010110 
Hi-I Hi-I 


1101 
Lo-I 








ASCII 
Character 


ADE 






Hi-I 
Hi-I 
Lo-I 


; 1 ! 


000010 


= 


B 
V 


66 
86 

45 




1 


010110 


01 


• 1101 




t 


Decimal -2413 
Encoded form BV- 






sign 








4526-35 



Figure 5-1 . How Integers Are Encoded. 
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Lo-I: The Lo-I character may be the only character. It 
contains the sign bit and the four least-significant 
bits of the integer: 

1 s d d d d 

The first two bits are always set to and 1 ; the third 
bit represents the sign of the integer. A negative 
integer is represented by a 0; a positive integer is 
represented by a 1 . The next four characters are 
the least significant bits of the integer. 

In the example in Figure 5-1 , Lo-I would be: 

10 110 1 

This corresponds to the - (hyphen) character on an 
ASCII chart. 



Integer Parameters in Setup Syntax 

Whsrssvsr you usg an Jnt9Q@r par3mst©r In e °* 1 ,ri sv"i + 3x 
simply enter the value. For example, to set both the transmit 
and receive rate to 2400 using the BAUDRATE Setup com- 
mand, enter: 

BAUDRATE 2400 2400 



Small Integer Parameters in Host Syntax 

In some commands, the parameter type called for is a small 
integer. Like the small integers used in Setup syntax, the 
host small integers represent ADE values from through 
1 27. However, in Host syntax you must encode these val- 
ues, just as you encode any other integer (as explained in 
the preceding paragraphs). This means thai the host must 
send for the character N u (ADE 0), B0 for the character s p 
(ADE 32), CO for the character (ADE 48), and so forth 
through G? for the character d t (ADE 1 27). 



Integer Array Parameters in Host Syntax 

Some commands take integer array parameters. Integer 
array parameters consist of sequences of integer parame- 
ters. The first integer tells how many items are in the array; 
subsequent integers represent individual array items. You 
encode each item in the array the same way you encode a 
single integer, as described under "Integer Parameters in 
Host Syntax." 



For example, you would send the array of integers (1 , 5, -1 , 

i vj i\j ii ic ici ii ill icii as luiiuvvo. 

integer array: (1,5,-1,16) = integer:4 (the count of 4) 

integer: 1 
integer:5 
integer:-1 
integers 6 

= 415SA0 



Integer Array Parameters in Setup Syntax 

Like the Host syntax integer array, the Setup syntax integer 
array consists of a sequence of integer parameters. Unlike 
the host, there is no item count at the beginning of the array, 
and there is no need to encode the integers. Following the 
Setup command name and a space, you simply enter the 
value of each item in the array, separating each item with a 
space or a comma. 

Some commands that have multiple parameters may use 
an integer array for one or more of those parameters. If you 
need to include more than one integer array parameter in a 
command issued in Setup syntax, you must enclose all but 
the last integer array in angle brackets. For instance, 

SGMATCHINGCLASS<13 14> 3 4 5 

contains two integer arrays. The first consists of integers 1 3 
and 14, and the second consists of integers 3, 4, and 5. 

Real Parameters in Host Syntax 

A real number is a variable which may assume fractional 
values. Real numbers between -32767.0 and 32767.0 are 
sent to the terminal as real parameters. These consist of a 
pair of encoded integers (see "Integer Parameters in Host 
Syntax"). The first integer represents a number; the second 
integer represents the power of two by which that number is 
to be multiplied. 

For example, the number 1 .5 may be expressed as 3 times 
1 /2, or 3 times 2 to the power -1 ; hence 

real:1.5 = integer:3 integer:-1 
= 3! 

The number pi may be approximated as 25736/8192, or 
25736 times 2 to the power -1 3; hence 

reahpi = integer:25736 integer:-13 
= YH8- 
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Real Parameters in Setup Syntax 

In Setup syntax, the operator enters real parameters from 
the keyboard by entering the number and the power of two 
as integers (see "Integer Parameters in Setup Syntax"). 
The examples just given for Host syntax can be entered in 
Setup syntax as follows: 

real: 1.5 = 3-1 
and 

reakpi = 25736 -13 



XY-Coordinates in Host Syntax 

The host must encode each xy-coordinate into one to five 
ASCII characters. The valid range of xy-coordinates is to 
4095. The xy-coordinates (53,1000), for example, would be 
encoded and sent to the terminal as the following characters: 

'az^M 

Figure 5-2 illustrates how the encoding process works. 
First, the decimal numeral is translated into a 1 2-bit binary 
numeral. Then the digits of the binary numeral are encoded. 
In the encoding process, the bits are divided into///, Lo, 
and Extra bytes. 



In the example in Figure 5-2, decimal 53 translates to 
binary: 

00000 01101 01 

Decimal 1000 translates to binary: 
00111 11010 00 

The digits are encoded and transmitted in the order in which 
the following explanations are given: 

Hi-Y: Contains the five most significant bits of the binary 
numeral representing the y-coordinate of the xy- 
parameter. The seven-bit Hi-Y character (exclud- 
ing the parity bit) has the following format: 

1 y y y y y 

The first two bits must be set to 1 , as shown. The 
characters "y y y y y" represent the five most 
significant bits of the y-coordinate. In the example 
in Figure 5-2, this byte is: 

10 111 

This corresponds to the apostrophe (') character. 

You can omit the Hi-Y byte if the five high-order bits 
of the y-coordinate have not changed since the last 
xy-coordinate was sent. 



X-Coordinate = decimal 53 




(53,1 


000) 




Y-Coordinate = decimal 1000 




= binary 00000 
Hi-X 


01101 
Lo-X 


01 

Second 
Extra 






ASCII 
Character 




binary 


00111 
Hi-Y 

ADE 


11010 00 

Lo-Y First 
Extra 




Hi-Y 

Extra 
Lo-Y 
Hi-X 
Lo-X 


j 01 
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M 






39 
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32 
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First Second 
Extra Extra 

00 01 
11010 
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01 


00000 


10 : 


01101 | 






XY-Coordinate 


= 'az s pM 






























4526-36 



Figure 5-2. How XY-Coordinates Are Encoded. 
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Extra: Contains the two least significant bits of the x- and 
y-coordinates. The seven-bit ASCII character has 
the foiiowing format: 

1 1 y y x x 

The first three bits must be set to 1 1 0, as shown. 
The characters "y y x x" represent the two least 
significant bits of the y- and x-coordinates, respec- 
tively. In the example in Figure 5-2 this byte is: 

1 10 1 

This corresponds to the letter a on the ASCII chart. 

You can omit the Extra byte if you only want to 
send coordinates with 1 bits of precision or if the 
two least significant bits of the x- or y-coordinate 
have not changed since the last xy-coordinate. If 
you do send the Extra byte, you must follow it with 
a Lo-Y bite. 

Lo-Y: Contains the five intermediate bits of the y-coordi- 
nate. The seven-bit ASCII character has the follow- 
ing format: 

1 1 y y y y y 

The first two bits must be set to 1 1 , as shown. The 
characters "y y y y y" represent the five inter- 
mediate bits of the y-coordinate. In the example in 
Figure 5-2, this byte is: 

11110 10 

This corresponds to the letter z on the ASCII chart. 

You can omit the Lo-Y byte if the following condi- 
tions are all true: 

• These five bits have not changed since the 
last xy-coordinate. 

• You are not sending the Extra byte. 

• You are not sending the Hi-X byte. 



Hi-X: Contains the five most significant bits of the x- 
coordinate of the xy-parameter. The seven-bit 
ASCII character has the following format: 

1 x x x x x 

The first two bits must be set to 1 , as shown. The 
characters "x x x x x" represent the five most 
significant bits of the x-coordinate. In the example 
in Figure 5-2 this byte is: 

10 

This corresponds to the ASCII s p (space) character. 

You can omit the Hi-X character if the x-coordi- 
nate's most significant bits have not changed from 
the last xy-coordinate sent. If you do send the Hi-X 
character you must precede it with the Lo-Y byte. 

Lo-X: Contains the five intermediate bits of the x-coordi- 
nate. The seven-bit ASCII character has the follow- 
ing format: 

1 x x x x x 

The first two bits must be set to 1 0, as shown. The 
characters "x x x x x" represent the five inter- 
mediate bits of the x-coordinate. In the example in 
Figure 5-2, this byte is: 

10 110 1 

This corresponds to the letter M on the ASCII 
chart. 

This character must always be sent, since it termi- 
nates the xy-parameter sequence. 



/vu/t 

Since the Lo-Y and Extra bytes each have high- 
order bits of "1 1 ", d t (binary 1 111111) 
could appear as a Lo-Y or Extra byte. This presents 
a problem for hosts that use d t as a filler character. 

If your host uses D ras a filler, have the host do the 
following things: 

• Send the two-character string E c? instead of D r 
since the terminal recognizes that string as a 
synonym for d t. 

• Send the terminal an IGNORE DELETES com- 
mand to cause the terminal to ignore all d t char- 
acters sent from the host. 



4107/4109 PROGRAMMERS 



5-5 



4100-STYLE COMMANDS & REPORTS 
COMMAND CONVENTIONS 



Integer Report Parameters in Host Syntax 

When the terminal sends integers to the host, it sends them 
encoded as three characters in an integer report. The way 
the terminal encodes integer reports is similar, but not iden- 
tical, to the way the host encodes integer parameters (see 
"Integer Parameters in Host Syntax"). Integer report 
parameters have these characteristics: 

• The terminal may include an EOL string, but sends it 
only if there is no other way to avoid exceeding the cur- 
rent maximum line length. 

• Unlike integer parameters, integer reports always have 
three characters. 

^ The encodino scheme for an inte n er report's Lo-i charac- 
ter is identical to that of the integer parameter. 

• The encoding scheme for an integer report's two Hi-I 
characters uses a different "offset" than for an integer 
parameter. In an integer parameter's Hi-I character, 64 is 
added to a six-bit binary numeral to form the ASCII deci- 
mal equivalent of the Hi-I character (this is the 1 seen at 
the beginning of the Hi-I's in Figure 5-1). In an integer 
report's Hi-I characters, 32 (rather than 64) is added to 
the six-bit binary numeral. 

If, for example, we use the binary representation of -241 3 
shown in Figure 5-1 , the first Hi-I character will be: 

Six-bit binary 000010 

Add offset of 32 +0100000 

= 0100010 



= ASCII character " 



The second Hi-I character will be: 

Six-bit binary 010110 

Add offset of 32 + 01 00000 

= 0110110 



= ASCII character 6 



The Lo-I character is encoded in the same way as the inte- 
ger parameter and will be: 

0101101 = ASCII character - 

Thus, if the terminal sends the number -241 3 to the host as 
an integer report, it encodes that number as "6-. 



4100-STYLE COMMAND AND 
REPORT DESCRIPTIONS 

This part of the section includes explanations of the termi- 
nal's 4100-style commands and reports. The commands 
are presented alphabetically according to their descriptive 
names. Figure 5-3 shows the format in which commands 
are explained. 

COMMAND CONVENTIONS 

There are four different kinds of 4100-style escape 
sequence commands: 

• A singie character 

• The E c character followed by one character 

• The E c character followed by two characters 

• The E c character followed by two characters and one or 
more parameters 

Figure 5-3 illustrates the general syntax conventions used 
in this section of the manual. Almost every command in this 
section has a Host syntax form; many commands have both 
a Host syntax form and an English-style Setup syntax form. 
Some commands have just a Setup syntax form. 

NOTE 

Parameters cannot be omitted from commands 
that you enter in Host syntax. If a parameter is 
omitted, the terminal interprets the next character 
sent by the host as the missing parameter. The 
results are unpredictable. 

Parameters can be omitted from commands 
entered in Setup syntax from the keyboard. This is 
generally true if the parameter is the only one in the 
command or is the last of two or more parameters, 
but may not be true in all cases. 
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The following points summarize the formats illustrated in 
the syntax boxes in Figure 5-3. 

• Characters shown in bold type are those you must enter 
exactly as shown. 

• Parameter names are shown on separate lines to make 
the command syntax easier to read. However, when 
entering commands, follow these rules: 

• In Setup syntax, parameters should be on the same 
line. The first character after the command name 
must be a space; use one or more spaces or one 
comma to separate parameters. 

• In Host syntax, parameters should be on the same 
line with no spaces between any of the parameters, 
or between the E c and following letters or parameters. 

• Multiword items are joined by hyphens. For example, 
parameter-name and next-parameter-name axe single 
items described by two or more words. 

• Three periods following a parameter (. . .) indicate that it 
can be repeated. 

As you can see in Figure 5-3, individual descriptions of each 
parameter follow the syntax boxes. Included are the param- 
eter type, range of valid values, and default values. Any 
additional discussion of a parameter follows these parame- 
ter descriptions. The three default types have the following 
meanings: 

• Factory — The value assigned a parameter when the 
terminal is shipped from Tektronix; parameters can be 
restored to this value by issuing the FACTORY command 
or running the Extended Self-Test program. 

• Power-Up — The value assigned a parameter when the 
terminal is first turned on. The term "Saved in memory" 
indicates that the parameter takes on the value saved in 
the terminal's nonvolatile memory. 

• Omitted — The value assigned a parameter if the com- 
mand is used and no value is specified for the parameter. 
This is true only in Setup syntax; parameters cannot be 
omitted in Host syntax. 

Any additional discussion or explanation of either a parame- 
ter or the command in general follows the parameter 
descriptions. 



DESCRIPTIVE COMMAND NAME 

A short statement describing the purpose of the command. 
Host Syntax 



E cQQ parameter-name 

next-parameter-name 



Setup Syntax 



ociwniniiiL |_<ai aiiiGici -i lait ic 

next-parameter-name 



parameter-name: parameter type; what it does. Explana- 
tions include the range. 

Defaults: Factory = Value when manufactured 
Power-Up = Value when turned on 
Omitted = Value if none specified 

next-parameter-name: The next parameter is explained. 
Defaults: Factory = Value 

Power-Up = Value 

Omitted = Value 



Figure 5-3. Command Description Format for 4100-Style 
Commands. 
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BEGIN GRAPHTEXT CHARACTER 

Starts the definition of a graphtext character in the specified 
graphtext font. 

Host Syntax 



E cST font-number 

character-number 



Setup Syntax 



GTBEGIN font-number 

character-number 



font-number: integer; specifies the font number in which 
the character being defined resides. Must be in the range 
through 32767. 

character-number: integer; specifies the decimal equivalent 
of the character being defined. Must be in the range 32 
through 126. 

A graphtext character definition consists of a BEGIN 
GRAPHTEXT CHARACTER command, a number of MOVE 
and/or DRAW commands, and an END GRAPHTEXT 
CHARACTER command. 



Before a graphtext character can be defined, a SET 
GRAPHTEXT FONT GRID must be saved for the specified 
font. The character being defined is displayed during its 
definition; to display the character after it has been defined, 
all the following conditions must be met: 

• The current graphtext font is the same as the font named 
in the font-number parameter. (See the description of the 
SET GRAPHTEXT FONT command.) 

• The current graphtext precision is "Stroke." (See the 
description of the SET GRAPHTEXT PRECISION 
command.) 

• The specified character occurs within a GRAPHIC TEXT 
command's string parameter. (See the description of the 
GRAPHIC TEXT command.) 

The character definition uses the current pivot point to posi- 
tion the font grid and to define the character origin. Display- 
ing the character places its origin at the current graphics 
beam position. 

Fonts 0, 1 , 2, 3, 9, and 1 2 are predefined fonts for the ASCII, 
Swedish, German, United Kingdom, Danish/Norwegian, 
and French character sets, respectively. If you define a 
character in one of these predefined fonts, that user-defined 
character supercedes the corresponding predefined char- 
acter. If you later delete the character definition with a 
DELETE GRAPHTEXT CHARACTER command, the char- 
acter is restored to its predefined definition. 
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BEGIN HIGHER SEGMENT 

Ends the current segment definition and begins a new seg- 
ment that has an ID number one higher than the segment 
just ended. 

Host Syntax 



E cSN 



BEGIN LOWER SEGMENT 

Ends the current segment definition and begins a new seg- 
ment that has an ID number one lower than the segment 
just ended. 

Host Syntax 



E cSB 



Setup Syntax 



aeiup syntax 



SGUP 



If no segment is currently being defined when this com- 
mand is issued, the terminal detects an error and takes no 
action. 

The pivot point and position of the new segment are set to 
the current beam position. The current Pick-ID is set to one. 

The segment definition can be terminated by an END SEG- 
MENT command, a BEGIN NEW SEGMENT command, a 
BEGIN LOWER SEGMENT command, or another BEGIN 
HIGHER SEGMENT command. 



SGDOWN 



If no segment is currently being defined when this com- 
mand is issued, the terminal detects an error and takes no 
action. 

The pivot point and position of the new segment are set to 
the current beam position. The current Pick-ID is set to 1 . 

The segment definition can be terminated by an END SEG- 
MENT command, a BEGIN HIGHER SEGMENT command, 
a BEGIN NEW SEGMENT command, or another BEGIN 
LOWER SEGMENT command. 
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BEGIN NEW SEGMENT 

Begins a new graphic segment definition. 
Host Syntax 



E cSE segment-number 



Setup Syntax 



SGNEW segment-number 



*>t6*at-iu.-iLt*iiivci . n itcyoi , occult iSo new oe^mmii tj iu num- 
ber. Valid segment ID numbers are 1 through 32767. 
Defaults: Omitted = Error 

The pivot point and position of the new segment are set to 
the current beam position. The pick-ID is set to one. 

The segment definition can be terminated by an END SEG- 
MENT command, a BEGIN HIGHER SEGMENT command, 
a BEGIN LOWER SEGMENT command, or another BEGIN 
NEW SEGMENT command. 



BEGIN PANEL BOUNDARY 

Starts a panel definition. 
Host Syntax 



E cLP first-point 

draw-boundary 



Setup Syntax 



BEGINPANEL first-point 

draw-boundary 



first-point: xy-coordinate; indicates the first point in a panel 
boundary. The valid range of values is through 4095 for 
both the x- and y-coordinate. 
Default: Omitted = (0,0) 

draw-boundary: integer; choose one of the following: 

Specifies that the fill pattern covers the panel 
boundary 

1 Specifies boundary is displayed in the finished 
panel using the current line style and line index 

Default: Omitted = 

After issuing BEGIN PANEL BOUNDARY, you can define 
the boundary of the panel in either of two ways: 

• Put the terminal in either Vector or Marker mode and 
then send the coordinates of the boundary line end- 
points. 

• Use MOVE and DRAW to define the boundary line. 

You do not need to create the panel's last boundary line. 
When the terminal receives END PANEL, it closes the panel 
and fills it with the fill pattern specified in the most recent 
SELECT FILL PATTERN command. 
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You can define a panel when the terminal is in Marker 
mode. However, you cannot draw a marker during a panel 
definition when the terminal is in Marker mode. 

If you define a panel while a segment is open (see the 
BEGIN SEGMENT command) the panel definition will be 
saved as part of the segment definition. 



Multiple Panel Boundaries. You can create a panel with 
multiple boundaries as shown in Figure 5-4. To do this, send 
another BEGIN PANEL BOUNDARY when you want to start 
the second boundary (do not use END PANEL to close the 
first boundary). The second BEGIN PANEL BOUNDARY 
closes the first boundary and starts another boundary at the 
specified position. When you issue END PANEL, the last 
boundary is closed and the entire panel defined by the 
multiple boundaries is filled. 



(1500,1851) 




(1000,1000) 



Setup Command 



(2000,1000) 



Encoded Command From Host 



BEGINPANEL 1000,1000,1 
DRAW 1500,1851 
DRAW 2000,1 000 
DRAW 1000,1000 
BEGINPANEL 1333,1192,1 
DRAW 1500,1459 
DRAW 1667, 1192 
END PANEL 



E cLP"z'Zl 
E cLF. In + W 
^LF'^z/T 
E cLF' z'Z 

Fv-I P\=» i *M1 

E cLF+ 1 I +W 
E cLF)cj-@ 
E cLE 



Figure 5*4. Creating a Panel With Multiple Boundaries. 
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BEGIN PIXEL OPERATIONS 

Sets parameters for use in subsequent RASTER WRITE, 
RUNLENGTH WRITE, RECTANGLE FILL, and PIXEL 
COPY commands. 



NOTE 

The terminal issues a Level 2 error if an undefined 
surface is specified (see SET SURFACE DEFINI- 
TIONS command). 



Host Syntax 



E cRU 



surface-number 

ALU-mode 

bits-per-pixel 



Table 5-1 
ALU VALUES 



Setup Syntax 



PXBEGIN 



surface-number 

ALU-mode 

bits-per-pixel 



surface-number: integer; specifies the surface on which 
subsequent pixel commands will write (or read) their data. 
Must be chosen from the following: 

-1 Specifies the super surface (all bit planes of all 
surfaces) 

Specifies the current surface 

1 — 4 Specifies a particular surface 
Defaults: Factory = 1 

Power-Up = 1 
Omitted = 



ALU 






Mode 


Function 


Application 





no change 




7 


AXORB 


Fast Erase mode. Writes an image that 




(exclusive OR) 


you can later completely remove by 
repeating the same operation. That is 
because A = (A XOR B) XOR B. 


11 


B 


Replace mode. Replaces the existing 
image with the new pixels. This is the 
default AL U-mode. 


12 


AANDB 


Performs a logical AND function on the 
pixel color indices and displays the 
results. 


15 


A ORB 


Writes the new image on top of the 
existing image. Pixel values of in the 
command string do not affect raster 
memory. 



ALU-mode: integer; specifies arithmetic logic unit (ALU) 
writing mode. Valid values are 0, 7, 1 1 , 12, or 15. Table 5-1 
describes the function that each value selects. 
Defaults: Factory = 1 1 

Power-Up = 1 1 

Omitted = 

bits-per-pixel: integer; specifies the number of bits used to 
encode the color index for each pixel in subsequent RAS- 
TER WRITE and RUNLENGTH WRITE commands. Valid 
values are 0, 1 , 2, 3, 4, and 6; means no change. 
Defaults: Factory = 6 

Power-Up = 6 

Omitted = 
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BEGIN SEGMENT 

Begins the definition of a new segment, and resets the 
current Pick-ID to 1. 

Host Syntax 



E cSO segment-number 



CANCEL 

Cancels terminal operations and several terminal parame- 
ters and modes. 

Host Syntax 



E cKC 



Setup Syntax 



Setup Syntax 



SGOPEN segment-number 



segment-number, integer; Specifies the segment identifica- 
tion number. Valid segment numbers are 1 through 32767. 
Defaults: Omitted = Error 

If you specify a segment number for a segment that already 
exists, or if you use an invalid segment number, the terminal 
generates and reports an error. If another segment, 
graphtext character, or panel boundary definition is cur- 
rently open, the terminal generates an error and ignores the 
command. 

The segment will be defined with its pivot point at the loca- 
tion specified by the most recent SET PIVOT POINT com- 
mand. (See the description of the SET PIVOT POINT 
command for details.) If the segment's pivot point is to be 
different from that previously defined, it is important to issue 
an appropriate SET PIVOT POINT command before issuing 
the BEGIN SEGMENT command. 

A segment is made visible in the currently selected view 
when the END SEGMENT command terminates the seg- 
ment definition, unless a SET SEGMENT VISIBILITY com- 
mand for segment -2 has determined that newly-created 
segments are to be invisible. 

If you issue a SELECT VIEW command during a segment 
definition, the segment is made visible only in the currently 
selected view when the segment is closed. To make a seg- 
ment visible in all views, select each view and issue a SET 
SEGMENT VISIBILITY command with segment-number -2 
for each view. This makes all future segments visible in 
each view. 



CANCtL 



This command cancels all current terminal activity and 
resets to default values a number of terminal parameters 
and modes. 

When you issue this command (which has the same effect 
as pressing the Cancel key) it: 

• Puts the terminal in Alpha mode and terminates all of the 
following modes: 

• Vector mode 

• Marker mode 

• GIN mode 

• Bypass mode 

• Prompt mode 

• Snoopy mode 

• Removes the terminal from GIN mode as if a DISABLE 
GIN command were received. (See ENABLE GIN and 
DISABLE GIN commands.) 

e Unlocks the keyboard. (See LOCK KEYBOARD 
command.) 

• Terminates any copy or hardcopy function currently in 
progress. (See COPY command.) 

• Flushes input and output queues. (See SET QUEUE 
SIZE command.) Characters not yet sent to the host will 
be discarded and ignored. 
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CLEAR DIALOG SCROLL 

Clears (erases) the dialog buffer. 
Host Syntax 



E cLZ 



Setup Syntax 



CLEARDIALOG 



After the dialog buffer is cleared, the cursor returns to the 
Home position (upper-ieft corner of dialog area). 

Issuing CLEAR DIALOG SCROLL has the same effect as 
pressing the terminal's D Eras key. 

COPY 

Sends data from the host directly to an attached hard copy 
unit. 

Host Syntax 



E cJC source 
separator 
destination 



Setup Syntax 



COPY HO: TO destination 



source: character array; HO: (in uppercase or lowercase) is 
the only valid value. 

separator: character array; must be the characters TO (in 
uppercase or lowercase) or an empty array (parameter 
omitted). 

destination: character array (string in Setup syntax); must 
be one of the following: 

Host Setup 

HC: HC: The terminal's hardcopy port 

PO: PO: Peripheral Port 

P1: P1: Peripheral Port 1 



When the terminal receives this command, it passes all data 
it receives from the host directly to the specified port. The 
host is responsible for sending data that is meaningful to the 
device attached to the port. The copy terminates when the 
terminal detects an end-of-f ile string or when the operator 
presses the Cancel key. 

CRLF 

Specifies whether a c r character implies a l f. 
Host Syntax 



E cKR crlf-mode 



Setup Syntax 



CRLF crlf-mode 



crlf-mode: integer (keyword in Setup syntax); must be one 
of the following: 
Host Setup 

no c r does not imply l f 

1 yes c r implies l f 
Defaults: Factory = (no) 

Power-Up = Saved in memory 
Omitted = 1 (yes) 

When c r does not imply c r l f is set, a c r character is dis- 
played as a Carriage Return only, not as a Carriage Return 
+ Line Feed combination. A c r moves the cursor to the 
beginning of the current line, not the next line. 

When c r implies c r l f is set, a c r from the host or from the 
keyboard (if the terminal is in Local mode and the operator 
presses the Return key) is displayed as a Carriage Return 
+ Line Feed combination. The cursor moves to the begin- 
ning of the next line on the display. 

This setting affects only a c r sent to the terminal screen. 
When you press the Return key, for example, the implied l f 
character is not sent to the host. 
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DEFINE MACRO 

Creates and deletes macros, which can be expanded on 
command from the host, at the keyboard, or both. 

Host Syntax 



1. Get ADE values for X,Y, and Z. 



E cKD macro-number 
macro-contents 



Setup Syntax 



DEFINE macro-number 
string 



macro-number: integer; (key specifier or integer in Setup 
syntax); specifies the name of the macro being defined. 
Valid values in the range -1 50 through 32767. A value of -1 
deletes all volatile macros. 
Default: Omitted = 

macro-contents: integer array; specifies ASCII decimal 
equivalent (ADE) integers that represent the characters 
defining the macro. (Host syntax only.) 

string: delimited string; defines the macro. To use c r or the 
special editing characters in the macro definition, you must 
precede them with the literal character, see SET EDIT 
CHARS for information on the literal character. (Setup syn- 
tax only.) 

After a macro is defined, you can expand it either with 
EXPAND MACRO (for any macro) or by pressing a key 
corresponding to the macro number (for macros numbered 
-150 through 1 43, excluding -1). 

The following example shows how to define Macro 500 as 
"XYZ". 



Character 


ADE 


X 


88 


Y 


89 


Z 


90 



2. Convert the integers 500, 88, 89, and 90 to the termi- 
nal's integer format. 



integer 
500 

oo 

oo 

89 
90 



Converted 

Format 
_4 

CQ 

L.U 

E9 
E: 



3. Issue this command: 

E cKD_43E8E9E: 

The integer 3 indicates that three values follow. This con- 
vention is followed for all integer arrays. 

Volatile and Nonvolatile Macros. The Graphics Terminal 
section explains the difference between volatile and nonvol- 
atile macros. DEFINE MACRO defines and deletes only 
volatile macros. To define a nonvolatile macro, use DEFINE 
NONVOLATILE MACRO followed by SAVE NONVOLATILE 
PARAMETERS. 

Deleting Macros. To delete a specific macro in Setup syn- 
tax, enter DEFINE MACRO but don't include string after the 
macro number. In Host syntax, indicate a length of for 
macro-contents. The following example shows the com- 
mand in Host syntax form that deletes macro 500 (500 is _4 

in interior fnrmatV 
^» c - /■ 

E cKD_40 

To delete all macros, specify macro number -1 . The follow- 
ing Host syntax command deletes all macros (-1 is ! in 
integer format): 

E cKD!0 
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Key Macros. Table 5-2 shows how integers from -1 50 to 
143 (excluding -1) correspond to the terminal's keys. 
Macros in this range are called key macros. Note that the 
integer for most keys is the ADE of the character the key 
normally produces. 

As shown in Table 5-2, each key is associated with up to four 
macros: unshifted, shifted, Ctrl, and Ctrl-shifted (in some 
cases two or more of the unshifted/shifted positions access 
the same macro). 

Note that when you define a key in Setup syntax you can 
either enter the key's ASCII decimal equivalent or just press 
the key (provided this key normally produces an ASCII 
character). Enter the macro's definition as a delimited string 
rather than an array of ADE integers. For example, to define 
the Q key to send the characters QUIT, enter: 

DEFINE Q "QUIT" 

Key-Execute Character. A special character, called the key- 
execute character, can be included in a key macro to cause a 
macro to be used only at the terminal instead of being sent 
to the host. Enclose the string you want used locally 
between two occurrences of the key-execute character 
named in the last SET KEY EXECUTE CHARACTER. 

If the characters between the key-execute characters form a 
valid command, the terminal executes the command. Other- 
wise, the macro is displayed as if the operator typed it. 

Each key-execute character the terminal encounters in a 
macro switches how key macros are used. If the terminal is 
sending macros to the host, the key-execute character 
means "use what follows locally." If the terminal is currently 
using macros locally, the key-execute character means 
"send what follows to the host." 

Always include the second key-execute character in the 
macro. If you omit the second key-execute character, subse- 
quent macros are expanded at the terminal, even if they are 
intended for the host. This would continue until the terminal 
expands a macro that includes the key-execute character. 



Table 5-2 

MACRO NUMBERS INVOKED BY KEYS 1 
(North American Keyboard) 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctrl- 
Shift 


Standard 
Keyboard 


( 
[ 


91 


123 


27 


27 


and 

Function 

Keys 


! 
1 


49 


33 


49 


33 


@ 
2 


50 


64 


50 







# 
3 


51 


35 


51 


35 




$ 
4 


52 


36 


52 


36 




% 
5 


53 


37 


53 


37 




A 

6 


54 


94 


54 


30 




& 

7 


55 


38 


55 


38 




* 
8 


56 


42 


56 


42 




( 
9 


57 


40 


57 


40 




) 



48 


41 


48 


41 




- 


45 


95 


45 


31 




+ 


61 


43 


61 


43 




i 
] 


93 


125 


29 


29 




Rub 
Out 


127 


-34 


-35 


-36 




Esc 


27 


-37 


-38 


-39 




I 


124 


126 


124 


126 




Q 


113 


81 


17 


17 




W 


119 


87 


23 


23 




E 


101 


69 


5 


5 




R 


114 


82 


18 


18 




T 


116 


84 


20 


20 




Y 


121 


89 


25 


25 




U 


117 


85 


21 


21 




I 


105 


73 


9 


9 







111 


79 


15 


15 



See the appendices for macro numbers on other keyboards. 
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Table 5-2 (cont) 

MACRO NUMBERS INVOKED BY KEYS 
(North American Keyboard) 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctri- 
Shift 


Standard 


P 


112 


80 


16 


16 


Keyboard 
and 

Function 
Keys (cont) 


\ 


92 


96 


28 


28 


Back 


Q 


-40 


-41 


-42 




Line 
Feed 


10 


-43 


-44 


-45 




Tab 


9 


-46 


-47 


-48 




A 


97 


65 


1 


1 




S 


115 


83 


19 


19 




D 


100 


68 


4 


4 




F 


102 


70 


6 


6 




G 


103 


71 


7 


7 




H 


104 


72 


8 


8 




J 


106 


74 


10 


10 




K 


107 


75 


11 


11 




L 


108 


76 


12 


12 






59 


58 


59 


58 






39 


34 


39 


34 




Return 


13 


-49 


-50 


-51 




Z 


122 


90 


26 


26 




X 


120 


88 


24 


24 




c 


99 


67 


3 


3 




V 


118 


86 


22 


22 




B 


98 


66 


2 


2 




N 


110 


78 


14 


14 




M 


109 


77 


13 


13 




< 


44 


60 


44 


60 




> 


46 


62 


46 


62 




? 

/ 


47 


63 


47 


63 




Space 
Bar 


32 


-52 


-53 


-54 




F1 


i 128 


136 


I" 2 


-10 



Table 5-2 (cont) 

MACRO NUMBERS INVOKED BY KEYS 
(North American Keyboard) 



Keys 


Key 
Label 


Un- 
Shift 


Shift 


Ctrl 


Ctrl- 
Shift 


Standard 


F2 


129 


137 


-3 


-11 


Keyboard 

and 

Function 


F3 


130 


138 


-4 


-12 


F4 


131 


139 


-5 


-13 


Keys (cont) 


F5 


132 


140 


-6 


-14 




F6 


133 


141 


-7 


-15 




F7 


134 


142 


-8 


-16 




F8 


135 


143 


-9 


-17 




GEras 
Dialog 


-111 


-117 


-123 


-129 




Cancel 
Setup 


-112 


-118 


-124 


-130 




DCopy 
SCopy 


-113 


-119 


-125 


-131 




Menu 


-114 


-120 


-126 


-132 




DEras 
SEras 


-115 


-121 


-127 


-133 




Break 


-116 


-122 


-128 


-134 


Numeric 





-55 


-69 


-83 


-97 


Keypad 
Keys 


1 


-56 


-70 


-84 


-98 


2 


-57 


-71 


-85 


-99 




3 


-58 


-72 


-86 


-100 




4 


-59 


-73 


-87 


-101 




5 


-60 


-74 


-88 


-102 




6 


-61 


-75 


-89 


-103 




7 


-62 


-76 


-90 


-104 




8 


-63 


-77 


-91 


-105 




9 


-64 


-78 


-92 


-106 






-65 


-79 


-93 


-107 




, 


-66 


-80 


-94 


-108 




- 


-67 


-81 


-95 


-109 




Ent 


-68 


-82 


-96 


-110 


Joydisk 


Right 


-135 


-139 


-143 


-147 


Positions 


Up 


-136 


-140 


-144 


-148 




Left 


-137 


-141 


-145 


-149 



Down 



-138 



-142 



-146 



-150 
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DEFINE NONVOLATILE MACRO 

Creates and deletes both the volatile and nonvolatile ver- 
sion of a macro. 

Host Syntax 



E cKO macro-number 
macro-contents 



Setup Syntax 



NVDEFINE macro-number 
string 



macro-number: integer; (key specifier or integer in Setup 
mode); specifies the name of the macro being defined. Valid 
values in the range -1 50 through 32767. A value of -1 
means "all macros," other macro numbers refer to individ- 
ual macros. 
Default: Omitted = 



This command has the same effect as the DEFINE MACRO 
command, except it defines both the volatile and nonvolatile 
version of a macro, rather than just the volatile version. The 
only distinction between the DEFINE MACRO and DEFINE 
NONVOLATILE MACRO commands is that after the termi- 
nal is reset or the power is turned off, macros defined with 
DEFINE NONVOLATILE MACRO will remain (if an NVSAVE 
command was issued before the terminal was reset or 
turned off). 

NOTE 

This command must be followed by SAVE NON- 
VOLATILE PARAMETERS to actually save or 
u€ i€t e a macro in fiGnvGiuiue uierrtory. 

To delete a single nonvolatile macro, use DEFINE NONVOL- 
ATILE MACRO specifying an array length of for macro- 
contents, and then use SAVE NONVOLATILE 
PARAMETERS. 



macro-contents: integer array; specifies ASCII decimal 
equivalent (ADE) integers that represent the characters 
defining the macro. 
Default: Omitted = Empty array 

string: delimited string; defines the macro. To use c r or the 
special editing characters in the macro definition, you must 
precede them with the literal character; See SET EDIT 
CHARS for information on the literal character. (Setup syn- 
tax only.) 
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DELETE GRAPHTEXT CHARACTER 

Deletes the named character of the specified user-defined 
graphtext font. 

Host Syntax 



E cSZ font-number 

character-number 



Qotun Quntav 
— — -— f —»■■•=« 



GTDELETE font-number 

character-number 



font-number: integer; specifies the font from which the 
character is deleted. Valid values are: 

-1 Ail fonts 

— 32767 Specifies a font 

character-number: integer; specifies the decimal equivalent 
of a character within the specified font. Valid values are: 

-1 All characters 

32 — 1 26 Specifies a character 

If you specify -1 tot font-number, the command deletes the 
specified user-defined character in all fonts. If you specify - 
1 for character-number, the command deletes all user- 
defined characters in the specified font. 

When a user-defined graphtext character is deleted, it 

rm/prtc tn thp o^focnnnHinri nroHofinoH rharartor fnr that 

font. For most fonts, that is the same as the corresponding 
character in the standard ASCII font (Font 0). However, for 
Fonts 1 , 2, 3, 9, or 1 2, this is the corresponding character in 
the predefined Swedish, German, United Kingdom, Danish/ 
Norwegian, or French font. 

Specifying a character-number of -1 not only deletes all the 
characters in the specified font, but also deletes the 
graphtext font grid for that font. 



DELETE SEGMENT 

Removes a segment from memory. 
Host Syntax 



E cSK segment-number 



Setup Syntax 



Qf^DPI CTC canmonf.ni imhar 



segment-number, integer; specifies the number of the seg- 
ment to be deleted. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing class 

-1 All segments (except Segment 0) 

1 — 32767 A specific segment 
Defaults: Omitted = Error 

If the segment is currently being defined, the segment defi- 
nition is terminated, and then the segment is deleted. 

The display is updated to the extent specified by the most 
recent SET FIXUP LEVEL command. 

Segments cannot be protected against deletion. Before 
issuing the DELETE SEGMENT command, take care that 
the command is really needed and that the segment num- 
ber being deleted is correct. 

If all conmontc anrl all \/ip\wc arcs tn hp HolotoH it ie factor tn 

delete views first, and then delete segments. It is also faster 
to set the fixup level to 0, delete the segments, renew the 
view, and then restore the original fixup level. 
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DELETE VIEW 

Deletes a specified view. 
Host Syntax 



E cRK view-number 



Setup Syntax 



VDELETE view-number 



view-number: inteyei , specifies the view to be deleted. Vaiid 
values for view-number are: 
-1 All views 

The current view 

1 — 64 A specific view 
Defaults: Omitted = 

If the current view is deleted, the next view higher (or the 
lowest remaining view if none higher exist) becomes the 
current view. If there are no other views (after view-number 
= -1 ), then View 1 (the default view) is selected and initial- 
ized. (See the SELECT VIEW command for details about 
the default view.) 

If you want to delete all segments and all views, it is faster to 
first delete views and then delete segments. 



DISABLE GIN 

Disables the GIN function on a named device. 
Host Syntax 



E cID device-function-code 



Setup Syntax 



GINDISABLE device-function-code 



device-function-code: integer; disables the specified GIN 
device and it's function. See Table 5-6 under the ENABLE 
GIN command for valid codes. 

This command disables the GIN function on the named 
device. If the RS-232 peripheral port has been programmed 
by the peripheral port system commands, the configuration 
in effect before the ENABLE GIN command will be restored 
when GIN is disabled. 

You can disable all GIN devices by specifying -1 for device- 
function-code. If you specify a device-function-code for an 
already disabled device, the command is ignored. In a simi- 
lar manner, if you specify a device that is not present, the 
command is ignored. When a device function combination 
is disabled, the terminal sends the rest of the GIN Report 
Sequence: the appropriate terminal signature character 
and EOM indicator. 
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DIM ENABLE 

Enables or disables the automatic screen-dim feature. 
Host Syntax 



1 E cKG dim-code j 


Setup Syntax 


i DIM dim-code 


i 

i 



dim- code : integer (keyword in Setup syntax); must be one of 
tine following : 
Host Setup 

no Disables automatic dim feature 

1 yes Dims screen after five minutes of no 

interaction. 
Defaults: Factory = 1 

Power-Up = Saved in memory 
Omitted = 
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DRAW 

Draws a vector from the current graphics position io the 
specified location. 

Host Syntax 



E cLG position 



Setup Syntax 



DRAW position 



position: xy-coordinate; indicates the point to draw to. The 

valid range of values is through 4095 for both the x and 

y-coordinate. 

Default: Omitted = (0,0) 

DRAW has the same effect as sending the terminal an xy- 
coordinate when the terminal is in Vector mode. The termi- 
nal can execute DRAW when it is in any mode except Ansi 
or Bypass mode. 

The terminal draws the vector in the current line style and 
line index. Use SET LINE STYLE to set the line style. The 
line index is set with SET LINE INDEX. 

DRAW does not affect the terminal's mode. For example, if 
the terminal was in Alpha mode when it received the DRAW 
command, it stays in that mode. 

See the section called The Graphics Terminal tor examples 
of how to create a iine. 



DRAW MARKER 

Draws a marker at a specified location. 
Host Syntax 



E cLH marker-position 



Setup Syntax 



MARKER marker-position 



marker-position: xy-coordinate; indicates the point where 
the marker is drawn. Valid range of values is through 4095 
for both the x- and y-coordinate. 
Default: Omitted = (0,0) 

DRAW MARKER has the same effect as sending the termi- 
nal an xy-coordinate when the ierminai is in Marker mode. 
The terminal can be in any mode except Ansi or Bypass 
mode when it executes DRAW MARKER. 

The marker specified by the most recent SET MARKER 
TYPE is drawn in the current line index; SET LINE INDEX 
sets the line index. 

DRAW MARKER does not affect the terminal's mode. For 
example, if the terminal is in Vector mode when it receives 
the DRAW MARKER command, it stays in that mode. 

The writing mode specified by the SET GRAPHICS AREA 
WRITING MODE command affects the way that a marker is 
arawn on me screen, oee me oc i unMi- mv^b «nc« «*nn- 
ING MODE command for details about how the writing 
modes operate. 
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ENABLE DIALOG AREA 

Enables or disables the dialog area. 
Host Syntax 



E cKA enable-mode 



Setup Syntax 



DAENABLE enable-mode 



enable-mode: integer (keyword in Setup mode); one of the 
following: 
Host Setup 

no Disables the dialog area 

1 yes Enables the dialog area 
Defaults: Factory = 1 (yes) 

Power-Up = Saved in memory 
Omitted = 1 (yes) 

When the dialog area is enabled and the terminal is in Tek 
mode, all alphatext is directed to the dialog buffer. (For the 
text to be seen, the dialog area must also be made visible; 
see SET DIALOG AREA VISIBILITY.) 

When the dialog area is disabled and, the terminal is in Tek 
mode, the terminal emulates Tektronix 4010 Series termi- 
nals, which do not have a dialog area. The terminal displays 
alphatext at the current position in the graphics area. 

In Ansi mode, the terminal automatically directs text to the 
dialog area, regardless of whether or not the dialog area is 
enabled. 



Table 5-3 summarizes the effects of enabling and disabling 
the dialog area. 

Table 5-3 
EFFECTS OF ENABLE DIALOG AREA 



Feature 


Dialog Area Disabled 


Dialog Area Enabled 


Destination of 
Alphatext 


Current position in 
terminal space 


Current alpha cursor 
position in dialog area 


G Eras Key 
S Eras Key 
and PAGE 


Erases the graphics 
area of the screen 
(S Eras also erases 
dialog area) 

Takes the terminal out 
of GIN mode 

Resets the terminal to 
Line Style 1 

Sets current position to 
Home position (0,3071) 

Puts terminal in Alpha 
mode 


Erases the graphics 
area (S Eras also 
erases dialog area) 


c r Character 


Puts terminal in Alpha 
mode 

Performs a carriage 
return action 

Resets the terminal 
Li ne Style to 1 

Takes the terminal out 
of GIN mode 


If the terminal is in 
Alpha mode, performs 
a carriage return in the 
dialog area 

No action if the terminal 
is in Vector or Marker 
mode 
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ENABLE GIN 

Enables the terminal for graphics input (GiN). 
Host Syntax 



E cIE device-function-code 
number-of-GIN-events 



Setup Syntax 



GINENABLE device-function-code 
number-of-GIN-events 



device-function-code: integer; enables the specified GIN 
device and the function for which that device is enabled. 
Device-function codes may be calculated by entering D 
(device) and F (function), from Tables 5-4 and 5-5, into the 
equation 8D + F. However, Table 5-6 lists ail valid device- 
function codes. 
Default: Omitted = 

number-of-GIN-events: integer; specifies the number of 
points whose xy-coordinate position will be reported in a 
GIN Report Sequence. This value decrements toward for 
each GIN Report Sequence. When the decrement value 
passes 1 , the GIN feature automatically disables. Specify- 
ing a value of 0, enables GIN for 65535 events. 
Default: Omitted = 65536 



Table 5-4 
DEVICE CODES 



Device 
Code 


Host Program Samples' 


Event Device 





Joydisk 


Keyboard 


1 


4957 Tablet at P0 


Tablet Pen or Puck 


2 


4957 Tablet at P1 


Tablet Pen or Puck 


6 


4957 in Delta mode at P0 


Tablet Pen or Puck 


7 


4957 in Delta mode at P1 


Tablet Pen or Puck 
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Table 5-5 
FUNCTION CODES 



Code 


Function 





Locator 


1 


Pick 


2 


Stroke 



Table 5-6 
VALID DEVICE-FUNCTION CODES 





Function 


Device* 


Locate 


Pick 


Stroke 


Joydisk 





1 


Not valid 


Tablet Port 


8 


9 


h n 
i \j 


Tablet Port 1 


16 


17 


18 


Delta Mode Device P0 


48 


49 


Not valid 


Delta Mode Device P1 


56 


57 


Not valid 



Only one device may be enabled en a given port at any time. 




Undesired results may occur if the terminal is 
simultaneously enabled by graphics input com- 
mands ENABLE GIN and ENABLE 4010 GIN. 

Thic rnmmanrl onahlee the terminal fnr nranhins input from 

a keyboard joydisk, or external graphics tablet. The device 
code selection lets the terminal know how to interpret data 
from a specific input device. The function code selection 
prepares the terminal for the mode selections of Locator, 
Pick, or Stroke. 



Only one device may be enabled on a given port at any time. 
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The GIN functions are: 

Locator Function. When the Locator function is enabled, a 
graphics cursor appears on the screen to provide interac- 
tive position information for the operator. As the operator 
moves the input device (joydisk, tablet pen or puck) over the 
input surface, the graphics cursor on the screen moves 
along in exact correspondence with the input device's xy- 
coordinate location. Up to this point, no information has 
been sent to the host in the form of a GIN report sequence. 
This only occurs by signaling a GIN Event as follows: 

• Joydisk Press a keyboard key 

• Pen Press the pen point against the tablet 

surface 

• Puck Press appropriate button on puck 

When the operator signals a GIN event, the GIN Report 
Sequence sent to the host contains the x- and y- coordinate 
for a particular location. (This is the location in terminal 
space of the graphics cursor. For further information, see 
the GIN Locator Report description, elsewhere in this 
section.) 

NOTE 

If the terminal is in Local mode then pressing a 
keyboard key cannot signal a GIN event, even 
though GIN may be enabled with the joydisk as the 
GIN device. The reason is that in Local mode char- 
acters typed on the keyboard are treated as if they 
came from the host rather than the keyboard. 

In raster terminals, several points in terminal space 
can map to each pixel in raster memory space. 
Thus, when moving the GIN cursor slowly, it is 
possible to move the true cursor (whose position in 
terminal space is reported to the host) without 
producing any visible motion in the image of that 
cursor in raster memory space. 

Likewise, if the window in terminal space is very 
small (as when the operator has "zoomed in " to see 
more detail), then adjacent points in terminal space 
may have images in the current viewport which are 
separated by some small distance. In that case, as 
the operator moves the cursor in terminal space, 
the image of that cursor moves in short steps from 
place to place in raster memory space. 



Pick Function. When the Pick function is enabled, a graph- 
ics cursor appears on the the screen. Pick compares all 
detectable segments within the pick aperture, returning the 
segment number and Pick-ID of the highest priority such 
segment, together with the xy-coordinate of the graphics 
cursor. For further information, see the GIN Pick Report 
description, elsewhere in this section. 

Stroke Function. When the Stroke function is enabled, the 
graphics cursor appears at a point on the screen which 
corresponds to the position on the tablet of the pen or tablet 
cursor. The operator begins a Stroke by pressing the tablet 
pen against the tablet, or pressing a button on the cursor 
tablet. The operator then moves the pen (or cursor) across 
the tablet surface and ends the Stroke by releasing pres- 
sure on the pen (or cursor button). During the Stroke, the 
terminal sends a continuous stream of x- and y-coordinates 
to the host. The quantity of reports sent to the host may be 
restricted by the SET GIN STROKE FILTERING command. 
Only the graphics tablet can be used with the stroke func- 
tion. For more information, see the GIN STROKE REPORT 
command. 

Delta Mode Device. The TEKTRONIX 4957 Graphics Tablet 
may also be enabled as a Delta mode (or mouse) device. 
When enabled in this mode, the GIN cursor position is not 
mapped directly from the position of the tablet puck, but is 
moved in the same direction as the puck is moved. 

This mode of operation is very similar to thumbwheel or 
joydisk GIN. Large motions of the cursor can be accom- 
plished with repeated small movements of the puck. The 
4957's proximity zone is approximately 1 .5 inches (4 cm) to 
keep the cursor from moving when you return the puck to 
the start of a movement it must be lifted out of proximity. 

When Delta mode is first enabled, the GIN cursor is posi- 
tioned at the last cursor position or at the position specified 
by the SET GIN START POINT command. 

NOTE 

The Stroke Function is not supported with the 
Delta Mode Device. 
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ENABLE KEY EXPANSION 

Enables or disables key macros. 
Host Syntax 



E cKW macro-expansion-mode 



Setup Syntax 



i/Tvr-vr^A »ll-k ! =K= _ i- 

i^t i tArHiiu 1 1 isur u-expansiun-moae 



macro-expansion-mode: integer: (keyword in Setup syntax); 
one of the following: 
Host Setup 

no Disables key expansion 

1 yes Enables key expansion 
Defaults: Factory = 1 (yes) 

Power-Up = 1 (yes) 
Omitted = 1 (yes) 

With DEFINE MACRO, you can define a key, so that it pro- 
duces a character (or characters) other than the character it 
normally produces. ENABLE KEY EXPANSION enables or 
disables alternate key definitions. 

This command does not delete macros. All key macros 
remain in memory and you can reenable them at any time. 

This command does not affect how the host uses macros. 
Even when key expansion is disabled, the host can still 
issue EXPAND MACRO to expand any macros, including 
those associated with keys. 

NOTE 

While ENABLE KEY EXPANSION is disabled, 
all key macros temporarily revert to their factory 
default values. 



ENABLE 4010 GIN 

Enables the joydisk for one graphics input (GIN) Locator 
event. 

Host Syntax 



This command is provided for compatibility with software 
written for earlier Tektronix terminals. It provides an abbrevi- 
ated way of enabling the joydisk for one GIN (graphics 
input) Locator event. The report which the terminal sends in 
response to this GIN event is in the 401 GIN Report format, 
rather than the GIN report sequence format used with the 
ENABLE GIN command. 




Undersired results may occur if the terminal is 
simultaneously enabled by graphics input com- 
mands: ENABLE GIN and ENABLE 4010 GIN. 



When the terminal receives an ENABLE 4010 GIN com- 
mand, it displays the graphics cursor assigned to device- 
function-code 0. (The default cursor is the crosshair cursor; 
however, this may be changed with the SET GIN CURSOR 
command.) 

i lie operator may then position the cursor by moving the 
joydisk. (The possible cursor positions are determined by 
the most recent SET GIN GRIDDING command for device- 
function-code — joydisk device, Locator function.) 

When the cursor is at the desired location, the operator 
presses any of the ASCII keys on the keyboard; this signals 
a GIN event. In response to this GIN event, the terminal 
sends a 4010 GIN Report. That report tells the host (a) 
which key the operator pressed, and (b) the location of the 
crosshair cursor in the terminal space. 

When 4010 GIN is enabled, pressing a key that has a key 
macro defined for it will cause an event for the first charac- 
ter of the macro which would normally be sent to the host. 
The remainder of the macro is expanded normally. 

When the terminal sends a report to the host, it enters 
Bypass mode. (See ENTER BYPASS MODE.) 
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After sending the 401 GIN Report, the terminal sets its 
graphics beam position to the position of the graphics cur- 
sor, and enters Alpha mode. This is done for compatibility 
with Tektronix 4010 Series terminals. 

if the dialog area is not enabled, then receiving a c r charac- 
ter, or a PAGE command, cancels the effect of the ENABLE 
401 GIN command and places the terminal in Alpha mode. 
Pressing the PAGE key has the same effect as the PAGE 
command. For details, see the description of the ENABLE 
DIALOG AREA command. 

If the dialog area is enabled, then the PAGE key, the PAGE 
command, and the c r character have no effect on graphics 
input, ihey do not cancei the effect of the ENABLE 4010 
GIN command. 

Terminal Settings for Emulating 4010 Series Graphics 
Input. To properly emulate a Tektronix 401 Series terminal 
during graphics input, several of the terminal's settings 
must be set a certain way. The exact settings may vary from 
one computer installation to another. Table 5-7 lists settings 
which should work for most host computers. 



Set the bypass-cancel-char to whatever is the last character 
that the host echoes in response to a report message from 
the terminal. If the host is not echoing characters sent from 
the terminal, set the bypass-cancel-char \o N u. If the host 
echoes c r as c r l f, set the bypass-cancel-char \o l f. If the host 
echoes c r as exactly c r, set the bypass-cancel-char to c r. 



4010 GIN Report 

When the operator presses an alphanumeric key to send 
the cursor position to the host program, the terminal gener- 
ates a 4010 GIN Report. This report tells the host program 
which key the operator pressed and the location of the cros- 



t»hiir r>\ irco*" "" 



r in -rormiriQ' er^a^p 



NOTE 

The 4010 GIN Report regards terminal space as a 
1024x1024 area rather than the 4096x4096 area 
used when specifying locations for display. 
Reported coordinate values must be multiplied by 4 
to give coordinates consistent with those used in 
other commands. 



Table 5-7 

TERMINAL SETTINGS TO EMULATE 4010 SERIES 
GRAPHICS INPUT 



Host Command 



Equivalent Setup 
Mode Command 



SET REPORT EOM FREQUENCY: 1 


REOM1 


= E clM1 




SET EOM CHARS: 0, 


EOMCHARS 


= E CNC00 




SET EOL STRING: C R 


EOLSTRING c R 


= E cNT 




integer-array: 13 




= E cNT1 = 




SET BYPASS CANCEL CHAR 


BYPASSCANCEL c r 


= E cNU 


BYPASSCANCEL N u 


integer: 


BYPASSCANCEL l f 


bypass-cancel-char 





The characters in the report are: 

1 . The ASCI I character corresponding to the key the 
operator pressed. 

2. The Hi-X character — the five most significant bits of 
x's binary value preceded by 01 . 

3. The Lo-X character — the five least significant bits of 
x's binary value preceded by 01 . 

4. The Hi-Y character — the five most significant bits of 
y's binary value preceded by 01 . 

5. The Lo-Y character — the five least significant bits of 
y's binary value preceded by 01 . 

Since only the ten most significant bits of the x- and y-coor- 
dinates are reported, the reported values are an approxima- 
tion of the graphics cursor position. After a host program 
converts reported coordinates by multiplying the values by 
4, the derived values can differ from the true values by up to 
three units. 
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Example 

If the operator positions the crosshair cursor at the point 
(50,1000) and then presses the lowercase "a" key, the 
following report is sent (in 1 024x1 024 terminal space): 

aS P ,': 

Figure 5-5 and the following explanations show why these 
five characters are sent. 

ASCII Character. The first character in the report is a, 
since that was the ke w the o n erstor n ressed. 

Hi-X Character. The x-coordinate in this example is 50, 
which converts to binary 0000 001 1 001 0. The Hi-X charac- 
ter always has the prefix 01 and is followed by the five high 
order bits in the binary numeral. So in this case, it is: 

0100000 

This is the space ( s p) character. 



Lo-X Character. This character has the prefix 01 followed 
uy tne live least signhicant uits Oi the x-coordinate. i niS 
produces: 

0101100 

This is a comma (,). 

Hi-Y Character. The y-coordinate in this example is 1 000, 
which converts to binary 001 1 11101 000. The Hi-Y charac- 
ter always has the prefix 01 and is followed by the five high 
order bits in the binary numeral. In this case, it is: 

0100111 

This corresponds to the apostrophe (') character. 

Lo-Y Character. The Lo-Y character in the report consists of 
the prefix 01 followed by the five least significant bits in the 
binary numeral: 

0111010 

This corresponds to the colon (:) character. 



X-Coordinate = decimal 50 


(50, 


000) 


Y-Coordinate = decimal 1000 




= binary 00000 01100 


10 




= binary 


00111 11010 00 




Hi-X Lo-X 


Not 
Used 




ASCII 
Character 


Hi-Y Lo-Y Not 
Used 

ADE 




Key 

Pressed 


1100001 


= 


a 


97 




Hi-X 


01 00000 


= 


s p 


32 




Lo-X 


01 01100 


= 


■ 


44 




Hi-Y 


01 00111 


= 


- 


39 




Lo-Y 


01 ; 11010 


= 




58 






GIN Report = 


= a s p , ' : 

















4626-38 



Figure 5-5. The GIN Cursor Position Report. 
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END GRAPHTEXT CHARACTER 

Terminates the graphtext character currently being defined. 
Host Syntax 



E cSU 



Setup Syntax 



GTEND 



END PANEL 

Terminates a panel definition. 
Host Syntax 



E cLE 



Setup Syntax 



ENDPANEL 



The panel boundary is closed, the panel is filled, and the 
current graphics beam position is set to the panel's first 
boundary point. 



END SEGMENT 

Terminates the segment currently being defined. 
Host Syntax 



E cSC 



Setup Syntax 



SGCLOSE 



ir a panel is currently Deing aennea witnm tne segment, that 
panel definition is also terminated, as if an END PANEL 
command had been received. 

When the END SEGMENT command is issued, the seg- 
ment that it terminates becomes visible in the current view 
(unless a SET SEGMENT VISIBILITY command for Seg- 
ment -2 has specified that newly created segments are to 
be invisible). 



ENTER ALPHA MODE 

Puts the terminal in Alpha mode. 
Host Syntax 



When the terminal is in Alpha mode, it interprets and dis- 
plays ASCII characters as text. Alpha mode is the terminal's 
power-up default. Text is sent to the dialog buffer if the dia- 
log area is enabled. If the dialog area is enabled and visible, 
text is also displayed in the dialog area as it is received. The 
u s character has an ASCII decimal equivalent (ADE) value 
of 31. 

The terminal exits Alpha mode when it receives an ENTER 
VECTOR MODE or ENTER MARKER MODE command. 
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ENTER BYPASS MODE 

Causes the terminal to enter Bypass mode. 
Host Syntax 



This command causes the terminal to enter Bypass mode. 
When the terminal is in Bypass mode it ignores all charac- 
ters from the host until it receives the bypass-cancel charac- 
ter. When the terminal receives this character, it leaves 
Bypass mode and discards the bypass-cancel character. 

The terminal automatically enters Bypass mode when it 
sends the first character of a terminal-generated Tek mode 
message to the host. The bypass-cancel character is usu- 
ally the character that the host sends the terminal after it 
reads a report from the terminal. For example: 

1 . Host sends E clQLI (How many lines in dialog area?). 

2. Terminal enters Bypass mode. 

3. Terminal sends report, terminated by the EOM 
character. 

4. Host echoes report to terminal. Report is ignored by 
terminal. 

5. Host sends l f (the bypass-cancel character). 

6. Terminal cancels Bypass mode. 

7. Host sends more data, which is processed by the 
terminal. 

The terminal does NOT enter Bypass mode to send Ansi 
mode reports, since these reports do not include end-of-line 
strings. 

If the current bypass-cancel character is set to N u, Bypass 
mode is disabled; in this case the ENTER BYPASS MODE 
command has no effect. 

See the discussion of Bypass mode in the Communications 
section for more on Bypass mode. See also the SET 
BYPASS CANCEL CHARACTER command description 
later in this section. 



ENTER MARKER MODE 

Puts the terminal in Marker mode. 
Host Syntax 



When the terminal is in Marker mode, it interprets ASCII 
characters as xy-coordinates and draws markers at the 
specified coordinates. (SET MARKER TYPE specifies the 
kind of marker the terminal draws.) The F s character has an 
ASCII decimal equivalent (ADE) value of 28. 

See "XY Coordinates in Host Syntax" at the beginning of 
this section for details on how to send those xy-coordinate 
parameters. 

The terminal cannot go directly from Marker mode to Vector 
mode; it must first be placed in Alpha mode, then in Vector 
mode. 

The use of Marker mode is explained and illustrated in The 
Graphics Terminal section. 



ENTER VECTOR MODE 

Puts the terminal in Vector mode. 
Host Syntax 



When the terminal is in Vector mode, it interprets ASCII 
characters as xy-coordinates. These coordinates specify a 
point to which a vector is to be drawn or a point to which the 
graphics beam is to be moved. The cursor moves to the first 
xy-coordinate specified; it draws a vector to subsequent 
points. The G s character has an ADE value of 29. 

To draw rather than move when specifying the first coordi- 
nate after entering Vector mode, include the b l character 
immediately after the G s character. 

See "XY-Coordinates in Host Syntax" at the beginning of 
this section for details on how to send those xy-coordinate 
parameters. 
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EXPAND MACRO 

Expands the specified macro. 
Host Syntax 



E cKX macro-number 



Setup Syntax 



EXPAND macro-number 



macro-number: integer; indicates the macro to expand. 
Valid range is -i50 through -2 and through 32767. When 
a -1 value (meaning all macros) is used with this command, 
a KX1 1 (Level 2) error is generated . 
Defaults: Omitted = Unchanged 

The EXPAND MACRO command causes the terminal to 
insert into its current input data stream the contents of a 
macro definition. It is a companion command to the DEFINE 
MACRO command, which defines a macro. 

If the EXPAND MACRO command comes from the host 
computer, it is treated by the terminal as if the host com- 
puter had sent the contents of the macro which is being 
expanded. 

Macros numbered from -150 through 143 may also be 
expanded by typing the corresponding key on the keyboard. 
The macro definition that is being expanded may contain 
other EXPAND MACRO commands. Commands may be 
nested this way to a nesting depth of at least 5. 

Key Macros. Key macros are expanded with the EXPAND 
MACRO command or by pressing the key (or combination of 
keys) to which the macro corresponds. 

The terminal treats any embedded EXPAND MACRO com- 
mand as if the commands came from the host in either of 
these cases: 

• An EXPAND MACRO command from the host triggered 
the expansion of the overall macro. 

• The key associated with the macro is pressed while the 
terminal is in the Local mode with local echo enabled. 



When a key macro is expanded by its corresponding key- 
stroke, and Setup mode is disabled and the terminal is not 
in Local mode, the macro is sent to the host communication 
port as if it had been entered at the keyboard. This method 
only works if the key macro was expanded by a keystroke 
and the terminal is not in Setup mode. If Local mode or local 
echo are enabled, the macro's contents, including the key- 
execute character, is sent to the command processor, so 
that any EXPAND MACRO commands in the nested con- 
tents are treated as if they had come from the host. 

When a key macro is expanded while Setup mode is 
enabled (either with a keystroke or with the EXPAND 
MACRO command), all characters within the macro-con- 
tents are treated as if they had been typed into the keyboard 
with Setup mode enabled, including EXPAND MACRO and 
other terminal commands. 

EXPAND MACRO commands or keystrokes for macros that 
are already being expanded are ignored. Recursive macro 
expansions are not allowed. 

With a GIN device enabled, pressing a key with a macro 
defined for it will cause a GIN event for each character in 
the macro which would normally be sent to the host (see the 
ENABLE GIN command). 

Host Macros. Host macros are expanded with the EXPAND 
MACRO command. 

EXPAND MACRO commands for macros that are already 
being expanded are ignored. Recursive macro expansions 
are not allowed. 

If the EXPAND MACRO command is entered when the 
terminal is in SETUP mode, the contents of the specified 
macro are treated as if they had been typed on the keyboard 
while the terminal was in Setup mode. 
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FACTORY 

Sets all parameters to their factory default values and takes 
the terminal out of Setup mode. 

Setup Syntax 



FACTORY 



To set parameters permanently to the terminal's factory 
default, issue SAVE NONVOLATILE PARAMETERS com- 
mand (NVSAVE in Setup) after issuing FACTORY. 

GRAPHIC TEXT 

Writes a string of graphtext starting at the current graphics 
position. 

Host Syntax 



E cLT text 



Setup Syntax 



GTEXTtext 



text: character array (delimited string in Setup syntax); 
indicates the characters to be displayed. Each character 
must have a decimal equivalent in the range 32 through 1 26 
( s p through ~). 
Defaults: Omitted = Empty string 

The terminal draws the text string, starting at the current 
beam position, in the direction determined by the latest SET 
CHARACTER PATH command. After the string is drawn, the 
beam position is updated to a point also determined by the 
latest SET CHARACTER PATH command. 



Stroke Precision Graphtext. If the most recent SET 
GRAPHTEXT PRECISION command specified stroke preci- 
sion, the graphtext is drawn as a series of vectors. Its 
appearance is governed by the most recent SET TEXT 
INDEX, SET GRAPHTEXT SIZE, SET GRAPHTEXT 
FONT, SET GRAPHTEXT SLANT, and SET GRAPHTEXT 
ROTATION commands. 

The text string is drawn in the current graphtext font, as 
determined by the most recent SET GRAPHTEXT FONT 
command. If no graphtext font has been selected, then 
Font is used. 

If the string is too long to fit in the 4096x4096 terminal 
space, the characters are clipped at the edge of terminal 
space. The current position is set to the edge of terminal 
space where the overflow occurred. 

Graphtext cannot be included in a panei. Therefore, if you 
attempt to use GRAPHIC TEXT between BEGIN PANEL 
BOUNDARY and END PANEL commands, an error results 
and the panel is closed as if END PANEL had been executed. 

String-Precision Graphtext. if the most recent SET 
GRAPHTEXT PRECISION command specified string-preci- 
sion, the graphtext is displayed as if it were alphatext, 
except that it does not wrap at the right edge of the display. 
The appearance of string precision graphtext is governed 
by the SET TEXT INDEX, SET GRAPHTEXT SIZE, and SET 
GRAPHTEXT ROTATION commands. 

The ANSI command SCS (SELECT CHARACTER SET) 
determines the character set used for graphtext. See the 
section titled Screen Editing for more information on charac- 
ter sets. 

The mode (Overstrike mode or Replace mode) selected by 
the SET GRAPHIC AREA WRITING MODE command 
affects the way that string precision graphtext is written. 
When in Replace mode, the terminal writes both the charac- 
ter and character background of each character cell to the 
graphics area. The character is set to the current text index, 
and the character background is set to the text background 
index specified by the most recent SET BACKGROUND 
INDICES command. When in Overstrike mode, only the 
character in each character cell is written. Stroke precision 
graphtext is not affected by Overstrike/Replace mode; it is 
always written as if the terminal were in Overstrike mode. 
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HARDCOPY 

Causes an attached hardcopy unit to make a copy of the 
terminal's screen or dialog area. 

Host Syntax 



E cKH hardcopy-code 



IGNORE DELETES 

Determines whether the terminal ignores the d t (Delete) 
character. 

Host Syntax 



E cKI ignore-deletes-mode 



hardcopy-code: integer; selects the portion of the display 
that is copied. Must be one of the following: 

or 1 Copies the entire screen 

2 Produces a positive hardcopy of the entire 

screen 

■i Copies only tne dialog area 

If you use 0, 1 , or 3, the copy will be a negative image of the 
display (white areas copy black, black areas copy white), 
which is the way a hardcopy normally appears and typically 
is most useful. If you prefer a positive hardcopy image, use 
hardcopy-code 2 in the command. 

Using this command has the same effect as pressing the S 
Copy, Ctrl-S Copy, or D Copy keys (hardcopy-codes and 1 , 
2, and 3, respectively). To copy only the graphics area, 
make the dialog area invisible and use or 1 . 



HELP 

Displays the escape sequence, Setup name, and parameter 
types for a command or cluster of commands. 

Setup Syntax 



Setup Syntax 



HELP name 



name: string; either a Setup mode command name or the 
name of a cluster of commands for which you want informa- 
tion. The cluster names are COMMUNICATIONS, GIN, 
HARDCOPY, and PIXELS. 
Default: Omitted = All commands 



IGNOREDEL ignore-deletes-mode 



ignore-deletes-mode: integer (keyword in Setup syntax); 
must be one of the following: 
Host Setup 

no Terminal does not ignore d t characters. 

yes Terminal ignores d t character. 

Factory = (no) 

Power-Up = Saved in memory 

Omitted = 1 (yes) 




1 
Defaults 



Some computers use d t characters (Delete or Rubout; 
ASCII decimal equivalent 1 27) as filler characters, sprin- 
kling them throughout the data stream sent to the terminal. 
These, in effect, slow down the communications rate and 
give the terminal time to react to information from the host 
without losing data or having to reset the baud rate. 

Since d t is a valid character in integer and xy-coordinate 
parameters, there are times when the terminal should proc- 
ess d ts as data, and other times when it should treat the 
character as a filler character and ignore it. This command 
tells the terminal which way to treat the d t character. 

See the heading "Coping With d t Filler Characters" in the 
Communications section for details on how to use this 
command. 
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INCLUDE COPY OF SEGMENT 

Copies the designated segment into the segment currently 
being defined. 

Host Syntax 



E cLK segment-number 



Setup Syntax 



SGINCLUDE segment-number 



segment-number, integer; specifies the number of the seg- 
ment to be included. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing class 

-i Ail segments 

1 — 32767 A specific segment 
Defaults: Omitted = Error 

When this command occurs in a segment definition, the 
terminal does the following: 

1 . Ends and fills a panel if one is being defined. 

2. Saves the current segment attributes (graphics beam 
position, line style, line index, text index, marker type, 
and pick-ID). 

3. Copies the designated segment (scaled, rotated, and 
positioned according to its current image transform 
parameters) into the segment being defined. 

4. Restores the current segment attributes previously 
saved. 

5. Displays the included segment in the current writing 
mode (that of the default segment) if no segment is 
currently being defined. 

When the included segment is copied, the initial default 
pick-ID is not copied, but all explicitly set pick-IDs are cop- 
ied. None of the included segment's attributes, such as 
highlighting or detectability, are carried over into the new 
segment. 



LEARN/NVLEARN 

Programs keys from the keyboard. 
Setup Syntax 



LEARN or NVLEARN 



A key programmed with LEARN remains programmed only 
until the terminal is turned off. A key programmed with 

M\/l CADM i-Amoinf rM-Artc^mmoiH iirttil \/r*i i ronmnrom it 

II V ^^J-linU1 I CI I I Gill IO pIVV^I CU III I IOU Winn Jfww ■ Vrf'f^i wy« ui ■ ■ ■<., 

even if the terminal is turned off. To program a key, first 
enter Setup mode, then type: 

LEARN c r or NVLEARN c r 

The terminal will respond with the message: 
Press the key to be defined: 

This key can be any key on the keyboard (except Cancel, 
Caps Lock, Ctrl, and Shift) including function keys, the 
Break key, a shifted space bar, etc. If you press an ASCII 
key, the terminal echoes the ASCII character on the screen. 
If you press a function key or one of the special keycodes, 
such as Shift-Return, the terminal echoes the decimal 
macro number. Then the terminal displays this message: 

Enter definition. (F1 terminates definition, F2 deletes 
last character) 

Now simply type in the ASCII definition (you don't need 
delimiters). If you make a mistake, use F2 to delete charac- 
ters. Each ASCII character you enter is added to the defini- 
tion until you press F1 , which ends the definition and puts 
you back into Setup mode. If you press any non-ASCII key 
(except F1 and F2) while typing the definition, the terminal 
ignores that key-press and rings its bell. 

You can cancel the definition before ending it by pressing 
the Cancel key. 

If there is not enough memory available to store a definition 
when you issue the LEARN command, the terminal returns 
control to Setup mode after displaying this message: 

Error: Not enough memory available. 

If, however, memory fills up while you are writing the defini- 
tion, the terminal rings its bell and ignores any other keys 
you press. 
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LFCR 

Specifies whether an l f character implies a c r. 
Host Syntax 



E cKF Ifcr-mode 



Setup Syntax 



LFCR Ifcr-mode 



Ifcr-mode. integer (keyword in Setup syntax); must be one 
of the following: 
Host Setup 

no l f does not imply c r 




1 
Defaults 



yes l f implies c r 
Factory = (no) 
Power-Up = Saved in memory 
Omitted = 1 (yes) 



When l f does not imply c r is set, the l f character is dis- 
played as a Line Feed only, not as a Line Feed + Carriage 
Return combination. 

When l f implies c r is set, an l f character from the host or 
from the keyboard (if the terminal in Local mode and the 
operator presses the Line Feed key) is displayed as a Line 
Feed + Carriage Return combination. 

This setting affects only a l f sent to the terminal screen. 
When you press the Line Feed key, for example, the implied 
c r character is not sent to the host. 



LOCAL 

Enters and exits Local mode. 
Setup Syntax 



LOCAL local-mode 



local-mode: keyword: 

yes Terminal enters Local mode 
no Terminal exits Local mode 



LOCK KEYBOARD 

Disables or enables the keyboard. 
Host Syntax 



E cKL locking-mode 



locking-mode: integer; specifies whether the keyboard is 
locked or unlocked. 

Unlocks the keyboard 

1 Locks the keyboard 
Defaults: Factory = 

Power-Up = 
Omitted = 

The LOCK KEYBOARD command lets the host computer 
disable the keyboard keys. When the keyboard is locked, 
the joydisk and all the keys except CANCEL and BREAK 
are inoperative. Pressing any key on the keyboard or manip- 
ulating the joydisk will ring the bell. The user can tell if the 
keyboard is locked (as opposed to the host echoing bells) by 
pressing the SHIFT key. If the keyboard is locked, the bell 
will ring. If it is unlocked, no character will be transmitted 
and the host will not echo a bell. (This is useful at times 
when a host computer program cannot tolerate input from 
the operator.) 

The keyboard can be unlocked by issuing a KEYBOARD 
LOCK command with a para/neter of 0. It can also be 
unlocked by pressing the CANCEL or BREAK key, or issu- 
ing a CANCEL command. 
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LOCK VIEWING KEYS 

Locks and unlocks the Zoom and Pan modes by disabling 
the F2 function/rame key. 

Host Syntax 



E cRJ locking-mode 



Setup Syntax 



LOCKVIEWINGKEYS locking-mode 



MACRO STATUS 

Displays the definition of one or all macros. 
Setup Syntax 



MACROSTATUS macro-number 



macro-number: integer or key specifier; specifies the macro 
whose definition you want displayed. Integer must be in the 



ranye -1 50 ihruuyh 32767. 
all displays all macros. 
Default: Omitted = All 



fhe int<syer-1 urthe keyword 



locking-mode: integer; (keyword in Setup syntax); one of 
the following: 
Host Setup 

no Unlocks the viewing keys 

1 yes Locks the viewing keys 
Defaults: Factory = 

Power-Up = 
Omitted = 

LOCK VIEWING KEYS disables the "frame" key when the 
Menu key's menu is displayed. Function key F2 is disabled 
so that pressing it only causes the terminal's bell to sound. 
That way, the operator cannot put the terminal in Zoom or 
Pan mode. 

The host computer can inquire whether a LOCK VIEWING 
KEYS command has been executed by issuing a Report 
Terminal Settings command for "RJ" opcode. The Terminal 
Setting Report sent in response to such a command not 
only tells the host whether the viewing keys are locked, but 
also reports whether the terminal is in Zoom or Pan sub- 
mode of Framing mode. For details, see the description of 
the Terminal Settings Report under REPORT TERMINAL 
SETTINGS. 
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MAP INDEX TO PEN 

Assigns the specified color index to a particular plotter pen. 
Host Syntax 



E cPI port-identifier 
index 
pen-ID-number 



Setup Syntax 



PMAP port-identifier 

iriuSx 
pen-ID-number 



port-identifier: string; must be PO: or P1 :. This selects the 
port to which the specified index is to be mapped. 

index: integer; must be in the range from -1 through 255. A 
value from through 255 specifies a particular color index; 
a value of-1 specifies "all indices." 

pen-ID-number: integer; must be in the range from 
through n, where n is the maximum number of pens for the 
plotter attached to the given port. A value of specifies "no 
pen"; an index assigned to Pen will not be drawn when 
the display is plotted. Values of n are: 

Plotter n 

4662 1 

4662 with multiple pens 8 

4663 2 

This command assigns a specific color index to a specific 
plotter pen number at the specified peripheral port. When 
graphic data is drawn on a plotter attached to that port, all 
color indices assigned the same pen-ID-number will be 
drawn with the same plotter pen. 

To draw all information in the same color, use an index value 
of -1 . To omit information with a particular color index from 
a plotted image, give that index a pen-ID-number of 0. 



MOVE 

Sets the current graphics position without drawing a vector. 
Host Syntax 



E cLF position 



Setup Syntax 



MOVE position 



position: xy-coordinate; specifies the new graphics position. 

Valid range of values is through 4095 for both the x- and 

y-coordinate. 

Defaults: Omitted = (0,0) 

This command does not change the display. It is analogous 
to lifting a pen from the paper in a drawing and moving it to 
a new location. 

The section titled The Graphics Terminal gives examples of 
how to use this command with the DRAW command to 
create lines. 
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PAGE 

Erases the screen (except the diaiog area). 
Host Syntax 



Vf 



This command has the same effect as pressing the termi- 
nal's G Eras key. 

if the diaiog area is enabied, the terminai erases the graph- 
ics portion of the screen and renews the current view (see 
the RENEW VIEW command). 

If the dialog area is not enabled , the terminal erases the 
graphics portion of the screen, renews the current view, 
and: 

• Resets the current line style to (solid lines) 

• Terminates 4010 GIN mode 

• Returns the graphic beam to its home position (0,3071 ) 

• Puts the terminal into Alpha mode 

• Cancels a command in Host syntax being entered from 
the keyboard or the host (Setup commands are not 
affected) 



PIXEL COPY 

Copies pixels from one rectanguiar region to another. 
Host Syntax 



E cRX destination-surface 

destination-lower-left-corner 

first-source-corner 

second-source-corner 



Setup Syntax 



PXCOPY destination-surface 

destination-lower-left-corner 

first-source-corner 

second-source-corner 



L 



destination-surface: integer; names the surface to which 
pixels are to be copied. Must be one of the following: 
-1 Specifies the super surface (all bit planes of 

all surfaces) 

Specifies the current surface 

1 — 4 Specifies a particular surface 
Defaults: Omitted = 

destination-lower-left-corner: xy-coordinate; specifies the 
lower-left corner of a rectangular region on the destination 
surface. The range of values for x is through 639; for y, 
through 511. 
Defaults: Omitted = (0,0) 

first-source-corner: xy-coordinate; specifies one corner of a 
rectangular region on the current pixel surface. The valid 
range of values for x is through 639; for y, through 511. 
Defaults: Omitted = (0,0) 

second-source-corner: xy-coordinate; specifies the corner 

opposite the first source corner in the source region. The 

valid range of values for x is through 639; for y, through 

511. 

Defaults: Omitted = (0,0) 
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The PIXEL COPY command copies the pixel at the first 
source corner to the lower-left corner of the destination 
region, which is the same width and height as the source 
region. Then it copies each remaining pixel in the source 
region onto a corresponding pixel in the destination region. 

The PIXEL COPY command uses the ALU mode specified 
in the most recent BEGIN PIXEL OPERATIONS command. 
Copying pixels to the same location on the pixel writing 
surface can only occur in XOR mode to erase the pixels, or 
in other ALU modes to form mirror images (see following 
"Source Corners" discussion). Using other ALU modes to 
copy (without mirroring) to the same location will do nothing, 
and will not generate an error. 

If the destination surface has fewer bit planes than the cur- 
rent surface, the destination surface receives only the most 
significant bits of each pixel index when the pixel is copied. 
For instance, if the current surface has three bit planes and 
the destination surface has only one, a pixel index with a 
binary value of 100 is copied to the destination surface as 1 . 

You can copy pixels using the off-screen raster memory with 
y values from 480 to 51 1 , but a Level warning will be gen- 
erated. 



NOTE 

The terminal issues a Level 2 error if an undefined 
surface is specified (see SET SURFA CE DEFINI- 
TIONS command). 

Source Corners. The two source corners need not be the 
lower-left and upper-right corners of the source region. 
However, if they are not, the pixels written to the destination 
region may form a mirror (or inverted) image of the picture 
formed by the pixels in the source region. The pixel at the 
first source corner is copied onto the pixel at the lower-left 
corner of the destination region. The pixel at the second 
source corner is copied onto the pixel at the upper-right 
corner of the destination region. 



PLOT 

Sends all visible segments to a specified output device; if 
device is a plotter, segments are drawn on the plotter. 

Host Syntax 



E cPL separator 

output-specifier 



Setup Syntax 



PLOT TO output-specifier 



separator: string; must be the string TO (upper or lower 
case) or omitted. 

output-specifier: string; specifies where information is to be 
sent by the PLOT command. Must be one of the following: 

PO: Specifies Peripheral Port 

P1 : Specifies Peripheral Port 1 

This command converts visible segments from the current 
view into escape-sequence commands and sends them to 
the specified output device. Only those segments — or 
parts of segments — within the window for the current view 
are sent to the output device. Segments that are clipped on 
the display at the boundaries of the current view will be 
clipped accordingly when they are sent to the output device. 
SET WINDOW and SET VIEWPORT commands are also 
sent, so that the output device knows the location of the 
view's window and viewport. 

If the most recent PORT ASSIGN command has assigned a 
plotter protocol to that port, then the terminal sends escape 
sequences in a format that the specified plotter can inter- 
pret. Otherwise, the terminal sends 41 10 Series escape- 
sequence commands to the destination device. 

The terminal terminates the transmission with the current 
end-of-f ile string for that port, as set by the SET PORT EOF 
STRING or SET EOF STRING command. 
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PORT ASSIGN 

Assigns a device protocol to a specified peripheral port. 
Host Syntax 



E cPA port-identifier 

protocol-identifier 



Setup Syntax 



PASSIGN port-identifier 

protocol-identifier 



port-identifier: string; must be one of the following: 

PO: Specifies Peripheral Port 

P1 : Specifies Peripheral Port 1 
Defaults: Power-Up = Saved in memory 
Omitted = Error 

protocol-identifier: string; must be one of the following: 
PPORT Assigns a generai purpose RS-232 
protocol. 

Assigns a protocol for a 4662 Plotter. 
Assigns a protocol for a 4662 Plotter 
equipped with Option 31 (multiple pens). 
This allows graphics with different color 
indices to be drawn with different plotter 
pens (see MAP INDEX TO PEN). 
Assigns a protocol for a 4663 Plotter. 

Defaults: Power-Up = Saved in memory 
Omitted = Error 



4662 
4662/MP 



4663 



This command assigns the specified device protocol to the 
specified port. 

PPORT Protocol. This is a general purpose protocol. When 
this protocol is used, the terminal does not format data sent 
to the specified port. Whatever data is sent to the port 
should already be in a format that the attached device can 
understand. 

Plotter Protocols. These protocols assume that the appro- 
priate Tektronix plotter is connected to the port and ready to 
receive data. Graphics commands are translated into 
escape sequence commands that the specified plotter can 
understand. Each of these protocols uses the plotter's block 
mode communications protocol. If tablet GIN is enabled for 
a particular port and the host issues a PASSIGN command 
for that port, a type PA1 1 error will occur: Port is in use. 



PROMPT MODE 

initiates or terminates Prompt mode. 
Host Syntax 



E cNM prompt-mode 



Setup Syntax 



PROMPTMODE prompt-mode 



prompt-mode: integer (keyword parameter in Setup syntax); 
must be one of the following: 
Host Setup 

no Terminates Prompt mode 

1 yes initiates Prompt mode after the next 

end-of-message character or end-of-line 
string is sent 

2 Initiates Prompt mode immediately 
(Host syntax only) 

Defaults: Factory = (no) 
Power-Up = 0(no) 
Omitted = 1 (yes) 

See Section 2, Communications, for an explanation of 
Prompt mode. 
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RASTER WRITE 

Specifies individually the color indices of a specified num- 
ber of pixels in the current pixel viewport starting at the 
current beam position. 

Host Syntax 



E cRP number-of-pixels 
color-index-codes 



Setup Syntax 



PXRASTERWRITE number-of-pixels 
color-index-codes 



number-of-pixels: integer; specifies the number of pixels 
represented by the character array that follows this parame- 
ter. Must be in the range through 65535. 
Defaults: Omitted = Error 

color-index-codes: character array; specifies in a packed 
format the color indices for the pixels specified by number- 
of-pixels. Each code is an ASCII character in the range s p 
through ' (ADE 32 through 96). 
Defaults: Omitted = 

You can regard the data bits embedded within the code 
characters in the color-index-codes array as a sequential 
string of bits. The bits are grouped to form color indices for 
individual pixels according to the bits-per-pixel parameter in 
the most recent BEGiN PIXEL OPERATIONS command. 
Figures 5-6 and 5-7 show how to pack color indices into the 
color-index-codes parameter. 



If bits-per-pixel is 3, then pack the color indices 0, 0, 2, 3, 2, 7 into a RASTER WRITE command as 
follows: 

1 . Express the color indices as three-bit binary numerals: 









2 


3 


2 


7 


I 


\ 


I 


I 


1 


\ 


000 


000 


010 


011 


010 


111 



2. Group the binary bits into six-bit groups: 

000 000 010 011 



010 111 



♦ * I 

000000 010011 010111 

3. Add 32 (binary 1 00000) to these six-bit binary numerals to form seven-bit ASCII characters: 



0100000 



0110011 

1 
3 



0110111 

\ 
7 



4. Issue a RASTER WRITE command. The command's first parameter is the integer 6, because the 
command holds six color indices. The second parameter is a character array holding the charac- 
ters s p, 3, and 7. 

RASTER WRITE = e cRP 6 3 s p37 



4526-39 



Figure 5-6. Packing Color Index Codes Using Three Bits per Pixel. 
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If you use 1 for the bits-per-pixel parameter in the BEGIN 
PIXEL OPERATIONS command, then six color indices 
(each consisting of a single bit) will fit into each code char- 
acter. If bits-per-pixel is 2, then three color indices fit into 
each code character. If bits-per-pixel is 3, then two color 
indices fit into each code character, as shown in Figure 5-6. 

If the bits-per-pixel parameter is set to 4, one-and-a-half 
color indices fit into each code character. That is, every pair 
of codes holds three color indices. Figure 5-7 shows the 
packing scheme. 

If the bits-per-pixel parameter is 6, the terminal interprets 
each code character as containing only one color index, 
which is determined by the four least significant bits. You 
can represent each color index in the range through 15 
with a single ASCII character. 



If the number of bits per pixel is greater than the number of 
bit planes on the current surface, the surface receives only 
the most significant bits of each color index sent. For 
instance, if the number of bits per pixel is 3 and the current 
surface has only two bit planes, a color index with a binary 
value of 1 1 is written to the current surface as 1 1 . In the 
case of six bits per pixel, if Color Index 8 (binary 001 000) is 
sent to a surface that has three bit planes, the bits 1 000 are 
sent and written to the surface as 1 00. 

The special code character ' (ADE 96), functions much like 

q C n L r com lonr^o- it mrt\/ae +h a n iX°! b63!T! n OSitJOn tO th.9 

start of the following row of pixels. The ' code is not included 
in the pixel count. 



If bits-per-pixel is 4, then pack the color indices 0,0,2,3,12,15 into a RASTER WRITE command as 
follows: 

1 . Express the color indices as four-bit binary numerals: 









2 


3 


12 


15 


\ 


1 


\ 


\ 


\ 


1 


0000 


0000 


0010 


0011 


1100 


1111 



2. Group the binary bits into six-bit groups: 



0000 



0000 0010 
« i 



0011 



1100 
II 



1111 



000000 



I 

000010 



001111 



\ 

001111 



3. Add 32 (binary 1 00000) to these six-bit binary numerals to form seven-bit ASCII characters: 



0100000 


0100010 


0101111 


0101111 


I 


1 


\ 


\ 


S P 


rt 


1 


1 



Issue a RASTER WRITE command. The command's first parameter is the integer 6, because the 
command holds six color indices. The second parameter is a character array holding the charac- 
ters^, ",/, and/. 

RASTER WRITE = E cRP 6 4V7/ 



Figure 5-7. Packing Color Index Codes Using Four Bits per Pixel. 
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RECTANGLE FILL 

Sets all the pixels in a rectangle to the specified color. 
Host Syntax 



E cRR lower-left-corner 
upper-right-corner 
fill-index 



Setup Syntax 



PXRECTANGLE lower-left-corner 

i innor-rtnht.ro rr\or 



fill-index 



lower-left-corner: xy-coordinate; specifies one corner of a 
rectangle in raster memory space. The range of values for x 
is to 639; for y, to 511. 
Defaults: Omitted = (0,0) 

upper-right-corner: xy-coordinate; specifies the opposite 
corner of that rectangle. The range of values for x is to 
639; for y, to 51 1 . 
Defaults: Omitted = (0,0) 

fill-index: integer; specifies the color index used to fill the 
rectangle. Must be in the range to 65535. 
Defaults: Omitted = 

The color indices are written into raster memory using the 
ALU mode and surface specified in the most recent BEGIN 
PIXEL OPERATIONS command. 

If the lower-left and upper-right corners of the rectangle 
have the same x-value, then the rectangle filled is one pixel 
wide. Likewise, if the lower-left and upper-right y-values are 
the same, then the rectangle filled is one-pixel high. 

This command also functions in off-screen raster memory 
where the y-value is 480 through 51 1 ; however, a Level 
warning will be generated. 



RENAME SEGMENT 

Renames (renumbers) an existing segment. 
Host Syntax 



E cSR old-segment-number 
new-segment-number 



Setup Syntax 



SGRENAME old-segment-number 
new-segment-number 



old-segment-number: integer; specifies number of the seg- 
ment being renamed. Must be in range 1 through 32767. 
Defaults: Omitted = Error 

new-segment-number: integer; specifies new name (num- 
ber) for the segment. Must be in range 1 through 32767. 
Defaults: Omitted = Error 

The existing segment number is changed to the new-seg- 
ment-number. If a segment with the new segment number 
already exists, an error occurs and the segment is not 
renamed. 



5-42 



4107/4109 PROGRAMMERS 



4100-STYLE COMMANDS & REPORTS 
REPORT DEVICE STATUS 



RENEW VIEW 



REPORT DEVICE STATUS 



Erases a specified view and redraws all segments visible in 
that view, including the border and the framing box, if appli- 
cable. 

Host Syntax 



E cKN view-number 



>ciup oyiuciA 



RENEW view-number 



view-number: integer; specifies the view to be renewed. 
Valid values for view-number are: 
-1 All views 

The current view 

1 — 64 A specific view 
Defaults: Omitted = 



If the view number is in the range 1 through 64, that view (if 
it exists) is renewed; that is, the viewport for that view is 
erased, and all the view's visible segments are redrawn. If 
the specified view does not exist, the terminal detects an 
error. 

Specifying for view-number renews the current view. 
Specifying -1 for view number erases the screen and then 
renews all views in sequence, ending with the current view. 



tou can group several views togetner in a view aispiay 
cluster. However, whenever a RENEW VIEW command is 
issued for any view in the cluster, all views in the cluster are 
renewed. For details, see the description of the SET VIEW 
DISPLAY CLUSTER command. 



Causes the terminal to send a Device Status Report to the 
host computer. 

Host Syntax 



E cJQ device-specifier 



device-specifier: specifies the device whose status is to be 

ronnrtflH trt +I"»a til-tot WolirJ ria.\Ars&,e> o«*£*- 
i uy\ji icu iu ii ic i iuji. vdnu ucvioco o.i c 

HC: Parallel hardcopy port (for 4695 Color Copier) 
PO: RS-232 Peripheral Port 
P1 : RS-232 Peripheral Port 1 
Defaults: Omitted = Error JQ11 

This command causes the terminal to send a Device Status 
Report for the specified device to the host computer. The 
device may be the color hardcopy interface (HC:), or an 
RS-232 peripheral port (PO: or P1 :). 

If a valid but not installed device is specified as the string 
parameter, the terminal detects Error JQ10 and returns as 
the status integer in the Device Status Report. 

If an invalid device-code is specified as the string parameter, 
the terminal detects error JQ1 1 . Nevertheless, the terminal 
sends a Device Status Report to the host computer with s p s p 
as the returned two-character device mnemonic, and as 
the status integer. 

The terminal enters Bypass Mode when sending this report 
(see ENTER BYPASS MODE). 



Device Status Report 

This report is sent in response to REPORT DEVICE STA- 
TUS. The report has the following format: 

signature-character 
device-specifier 
status-word 
EOM-indicator 

The following paragraphs detail the parts of the report. 

signature-character: the character for non-GIN reports, as 
set by the most recent SET REPORT SIG CHARS com- 
mand. If this character is N u, it is omitted. 
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device-specifier: two characters; specifying the device 
whose status is being reported: 

s p s p Invalid device 

PO RS-232 Peripheral Port PO 

P1 RS-232 Peripheral Port P1 

HC Color hardcopy interface 

status-word: integer; whose binary bits hold status informa- 
tion, see Tables 5-8 and 5-9. 



Table 5-8 
STATUS INTEGER FOR RS-232 PERIPHERAL PORT 



B15 


DI4 




Did 


D|2 


B11 




D1U 


on 





B7 





_ 

BO 


t*4 


B3 


B2 


tnifcto 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


B |p 



The meanings of these bits (when set to 1 rather than 0) are 
as follows: 

X Reserved for the future 
B Peripheral port is busy 
P This peripheral port is installed in the terminal. 
(This does not necessarily mean that there is a 
peripheral device attached to the terminal port.) 

Table 5-9 lists the meaning of bits in the status integer for 
color hardcopy device. 



Table 5-9 
STATUS INTEGER FOR COLOR HARDCOPY INTERFACE 



B15 


B14 


B13 


B12 


B11 


B10 


B9 


B8 


B7 


B6 


B5 


B4 


B3 


B2|B1 


BO 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


B 


P 



The meanings of these bits (when set to 1 rather than 0) are 

as follows: 

X Reserved f or the f utu re 

B The screen pseudo device is busy 

P The screen pseudo device is present 



REPORT ERRORS 

Causes the terminal to send an Error Report to the host. 
Host Syntax 



E cKQ 



The REPORT ERRORS command causes the terminal to 
send an Error Report to the host computer. In that message, 
the terminal reports the eight most-recently detected error 
codes, their severity levels, and how many times each error 
was detected. See the description of the Error Report for 

u6tailS. 

The most recent error will be returned first, and the "signa- 
ture" characters used are those which have been specified 
for reports. 

When the terminal sends a report to the host, Bypass mode 
is entered. (See ENTER BYPASS MODE Command.) 

Error Report 

The Error Report is sent in response to REPORT ER- 
RORS. This report is a series of up to eight individual 
error messages. The Error Report has the following 
format: 

report-for-one-error 

terminal-signature-chararacter 

EOM-indicator 

A single report-for-one-error message is sent for each of 
the eight most recently detected error codes. If fewer than 
eight errors have been detected since power-up or since the 
last REPORT ERRORS command then there are fewer than 
eight reports-for-one-error in the Error Report. 
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Each report-for-one-error is preceded by a signature-char- 
acter, as set by the SET REPORT SIG CHARACTERS com- 
mand. After the iast report-for-one-error, the terminal sends 
a terminal-signature-character and an EOM-indicator, this 
signals the end of the Error Report. 

The terminal does not send a signature-character if it is the 
N u character. Do not set the signature-character or terminal- 
signature-character \o N u, since lack of a signature character 
makes it difficult for the host to parse the Error Report. 

Besides the signature-character, each report-for-one-error 
includes a four-character error code, a severity level num- 
ber, and the number of times the terminal has detected that 
error since power-up or the last REPORT ERRORS com- 
mand. The error codes and severity levels are described in 
the Appendix. 

The EOM-indicator is sent to show between each error 
message in the report and at the end of the report to show 
that it is completed, if there are no errors to the report, the 
terminal sends one EOM-indicator. 



REPORT GIN POINT 

Forces the terminal to send a GIN report to the host. 
Host Syntax 



E clP device-function-code 



device-function-code: integer; enables the specified GIN 
device and function. See Table 5-6 under the ENABLE GIN 
command description for valid values. Numeric value -2 
reports the current graphics position. 
Defaults: Omitted = Error IP11 

The REPORT GIN POINT command forces the terminal to 
return to the host a GIN report for one GIN event, without 
any operator interaction. The GIN event can be a Locator 
event, a Pick event, or a Stroke event, depending on the 
command's device-function-code parameter. 



If GIN rubberbanding or inking is enabled for that device- 
function-code, then the terminal performs the appropriate 
rubberbanding or inking function on its display. 

The position returned is the location in terminal space of the 
graphics cursor for the specified device-function-code. 
Specifying -2 for the device-function-code causes the termi- 
nal to report the current graphics beam position. The format 
for the report is the same as a Locate Report. 

When the terminal sends a report to the host, Bypass mode 
is entered (see ENTER BYPASS MODE). 

Terminal Already Enabled for That Device and Function. 

If an ENABLE GIN command has already enabled the termi- 
nal for the specified device-function-code, then the 
REPORT GIN POINT command serves only to force a GIN 
event. The terminal behaves as if the operator had initiated 

LMtiOiix even i, CACepi mat uic nuvn ^ndidw«.i .t:«.wi ..w« as 

the "key pressed" part of the GIN report is always the s p 
character. 

Terminal Not Already Enabled for That GIN Device and 
Function. If the terminal was not already enabled for the 
specified GIN device-function-code, then the following 
occurs: 

1 . The terminal executes an implicit ENABLE GIN com- 
mand for that device-function-code and a count param- 
eter of 1 . 

2. The terminal sends to the host the GIN report sequence 
for the implicit ENABLE GIN it has just executed. In the 
report, the xy parameter shows the position in terminal 
space for the cursor curreniiy assigned to the specified 
device function combination. In the report, the "key 
pressed" ASCII-character parameter is the s p charac- 
ter. 

The graphics cursor "blinks" momentarily. (The graphics 
cursor turns on as the terminal executes the implicit 
ENABLE GIN command. Then it turns off again as the GIN 
REPORT sequence is sent to the host computer.) 
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GIN Report Sequence 

The GIN report sequence is best represented by a syntax 
graph as shown in Figure 5-8. 

A GIN report sequence is a sequence of reports that the 
terminal sends the host computer when the terminal has 
been enabled (by an ENABLE GIN command) for graphics 
input from a single GIN device. 

If more than one GIN device has been enabled, then the 
corresponding GIN report sequences may be interleaved. 
That is, the GIN-report-items and final-GIN-report-items 
from the various enabled GIN devices may be intermixed. 
(In that case, "signature characters" are used to distinguish 
the GIN-report-items for one GIN device from the GIN- 
report-items for another GIN device.) 

Overall Syntax. The GIN report sequence from a single GIN 
device consists of a series of GIN-report-items, terminated 
by afinal-GIN-report-item. 

GIN Report Items. The terminal sends a GIN -report-item 
each time a GIN event occurs. 

If the GIN device was enabled for the Locator or Pick func- 
tions, then a GIN event occurs when the operator presses a 
keyboard key (for the joydisk GIN device), presses the tab- 
let, pen or a button on the tablet cursor (for the tablet GIN 
device). 

If the GIN device was enabled for the Stroke function, then a 
GIN event occurs each time a new coordinate is to be sent 
to the host computer. With the Stroke function, this can 
happen many times a second. 

A typical GIN-report-item consists of a signature character, 
followed by a GIN report. The GIN report format depends on 
which GIN function was enabled; it is either a GIN Locator 
Report, GIN Pick Report, or GIN Stroke Report. In addition, 
an EOM-indicator (typically just the c r character) may be 
inserted at the start or end of the GIN-report-item. 



Signature Characters. The signature characters (signature- 
character and terminal-signature-character) are included for 
convenience when parsing the GIN report sequence. If two 
or more GIN devices are enabled at the same time, the 
signature characters serve to distinguish the GIN-report- 
items (and final-GIN-report-items) coming from one GIN 
device from those coming from the other GIN devices. 

Also, it is possible, even while GIN is enabled, to issue 
commands which cause the terminal to send a report to the 
host computer which is not part of the GIN report sequence. 
For instance, even while GIN is enabled, a REPORT TER- 
MINAL SETTINGS command can cause the terminal to 
send a Terminal Settings Report to the host computer. In 
that case, signature characters may be used to distinguish 
the Terminal Settings Report from the GIN-report-items in 
the GIN report sequence. 

The two signature characters (signature-character and ter- 
minal-signature-character) are determined by the most 
recent SET REPORT SIG CHARACTERS command for the 
particular GIN device-function-code. For details, see the 
description of the SET REPORT SIG CHARACTERS 
command. 

GIN Reports. The GIN reports for a single GIN device are 
all either GIN Locator Reports, GIN Pick Reports, or GIN 
Stroke Reports. The syntaxes of these are listed in Figure 
5-8 as part of the syntax for the GIN report sequence. For 
more details, however, you should refer to the separate 
descriptions of the GIN Locator Report, GIN Pick Report, 
and GIN Stroke Report, later in this command description. 

EOM Indicators Within GIN Report Items. The syntax for a 
GIN-report-item includes an optional EOM-indicator at the 
start of that item, and another optional EOM-indicator at 
the end of the item. 

By issuing a SET REPORT EOM FREQUENCY: 1 com- 
mand, you can cause an EOM-indicator Xo be sent at the 
end of each GIN-report-item. That way, each GIN-report- 
item is sent to the host as a single line of text. This may be 
convenient for writing host routines that parse the GIN 
report sequence. 
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Note: Read down for increasing detail. 



GIN REPORT SEQUENCE 



FINAL GIN REPORT ITEM | 



GIN REPORT ITEM 



(l) GiN REPORT ITEM 



© 



© 



EOM INDICATOR 



SIG CHAR 



uirj ncrun i 



EOM INDICATOR 



(3) GIN REPORT 



./ 



^-»-{ginijo ^ 



w 



GIN PICK REPORT 



\ 



GIN STROKE REPORT 7 "} - 



6) j/S 



©GIN LOCATOR REPORT 



r 



-*■ \ ASCII CHARACTER 



-H XY REPORT : 



CHARACTER OF THE KEY * CURSOR LOCATION * 

WHICH WAS PRESSED 



GIN PICK REPORT 



ASCII CHAR 



XY REPORT 



♦1 INT REPORT 



INT REPORT 



KEY PRESSED* CURSOR LOCATION I SEGMENT NUMBER * PICK ID NUMBER i 

© GIN STROKE REPORT 



H ASCII CHAR 



J I 



H XY REPORT 



KEY PRESSED * CURSOR LOCATION 



(2) FINAL GIN REPORT ITEM 



♦1 TERM SIG CHAR 



~7*~ 



EOM INDICATOR 



(3892)4893-13 



Figure 5-8. Syntax for a Single GIN Report Sequence. 
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However, you can also have the terminal fit several GIN- 
report-items in the same line of text (or in the same block, if 
using block mode). To do this, choose the "less frequent" 
option in the SET REPORT EOM FREQUENCY command. 
That is, issue a SET REPORT EOM FREQUENCY: com- 
mand. Also, choose a maximum line length (with the SET 
REPORT MAX LINE LENGTH command) which is sufficient 
to hold two or more GIN-report-items. 

Under these circumstances, the optional EOM-indicator at 
the start of each GIN-report-item becomes important. If 
enough GIN-report-items have been sent on the current 
line, so that even one more GIN-report-item would cause 
the maximum line length to be exceeded, then the terminal 
sends an EOM-indicator at the start of the next GIN-report- 
item. That EOM-aidicatoi' serves to terminate the current 
line, so that the maximum line length is not exceeded. The 
signature-character \h&\ follows would then be the first char- 
acter of the next line. 

Final GIN Report Item. The terminal sends afmal-GIN- 
report-item to the host computer when the graphics input 
function is disabled. This occurs when the ENABLE GIN 
command's "count" is exhausted, when the terminal 
receives a DISABLE GIN command, or when the operator 
presses the CANCEL key. TUefinal-GIN-report-item con- 
sists of a terminal-signature-character, followed by an EOM- 
indicator. 

Terminal Signature Character. The terminal-signature- 
character is a single ASCII character, which serves to notify 
the host that the GIN report sequence is ended. The termi- 
nal-signature-character, like the signature-character 
described earlier, is set by the SET REPORT SIG CHARAC- 
TERS command. 

EOM Indicator in the Final GIN Report Sequence. After the 
terminal-signature-character the terminal always sends an 
EOM-indicator. 



GIN Locator Report 

The GIN Locator Report has the following format: 

key 
cursor-location 



The following paragraphs detail the parts of the report. 

key: ASCII character; the character for the key or tablet 
switch that the operator pressed to signal a GIN event. If the 
GIN device is the tablet, then this character is Z, 1 , 2, or 3, 
depending on which button on the four-button cursor the 
operator presses. 

cursor-location: x-y report: the position of the graphics 
cursor when the operator signalled a GIN event. 

When the terminal is enabled for a GIN (graphics input) 
locator function, the graphics cursor appears and the opera- 
tor moves the cursor (e.g., with the joydisk) until it is posi- 
tioned at a location which is to be reported to the host 
computer. Then the operator signals a GIN locator event 
(e.g., by pressing a keyboard key). The terminal responds 
by sending a GIN Locator Report to the host. Each GIN 
Locator Report is preceded by a signature character. 



GIN Pick Report 

The GIN Pick Report has the following format: 

key 

cursor-location 
segment-number 
pick-ID-number 

The following paragraphs detail the parts of the report: 

key: ASCII character; the key that the operator pressed to 
signal the pick event. If the GIN device is the tablet, then 
this character is Z, 1 , 2, or 3, depending on which button on 
the four-button cursor the operator presses. 

cursor-location: xy-report; the position of the graphics cur- 
sor at the moment of the pick event. 

segment-number: integer-report; the segment number for 
the segment which the operator picked. The number is if 
no segment is detected in aperture. 



5-48 



4107/4109 PROGRAMMERS 



4100-STYLE COMMANDS & REPORTS 
REPORT GIN POINT 



pick-ID-number: integer-report; the Pick identification 
number for the part of the secjme.nt which the o n erator 
Picked. The number is if no segment is detected in aper- 
ture. 

When the terminal is enabled for a GIN (graphics input) Pick 
function, the graphics cursor appears and the operator 
moves the cursor (e.g., with the joydisk) until it is positioned 
at a segment which the operator wishes to "Pick." The 
operator then signals a Pick event (e.g., by pressing a key). 

\A/hon (ho r\r\c±r1*r\r cinnolc o r\\r*\f Ql/Qnt *Y\ a * Q rmln a ! rOtUmS 

a GIN Pick Report to the host computer. This occurs regard- 
less of whether there actually is a visible, detectable seg- 
ment within the current pick aperture. 

If more than one visible, detectable segment falls within the 
pick aperture, the segment Picked wi!! be the one with the 
highest display priority. 

For more details, see the descriptions of the SET PICK ID, 
SET SEGMENT VISIBILITY, SET SEGMENT DETECTABIL- 
ITY, SET SURFACE VISIBILITY SET PICK APERTURE, 
and SET SEGMENT DISPLAY PRIORITY commands. 



GIN Stroke Report 

The GIN Stroke Report has the following format: 

key 
cursor-location 



The following paragraphs detail the parts of the report. 

key: ASCII character; the first point in a stroke. The "key" 
character is Z, 1 , 2, or 3 depending on which cursor button 
was pressed. Subsequent points in a stroke are indicated 
with the letter J, and the last point with the letter O. 

cursor-location: xy-report; the location of the graphics cur- 
sor for one point of the stroke. 

When an ENABLE GIN command has enabled the graphics 
tablet for the Stroke function, the GIN reports sent to the 
host in the GIN report sequence are GIN Stroke Reports. 

For each Stroke that the operator performs at the tablet, 
many GiN StroKe Reports are sent to the host computer. 



First Point in the Stroke. The Stroke begins when the oper- 
ator places the cursor on the tablet surface and presses a 
button on the cursor. The terminal then sends the first GIN 
Stroke Report to the host computer. 

Subsequent Points. As the operator moves the cursor 
across the tablet, subsequent GIN Stroke Reports are sent. 
These report the positions through which the tablet pen or 
cursor moves. For each of these reports, the key field is the 
ASCI! character J. 

Last Point. The Stroke ends (a) when the ENABLE GIN 
command's count expires, or (b) when the operator stops 
pressing the pen against the tablet, removes the cursor 
from the tablet surface, or releases the button on the cursor. 
The stroke also ends if the terminal's output buffer is filled 
up; more about that later. 

If the Stroke ends by the ENABLE GIN command's count 
expiring, then the last point In the Stroke is a valid data point 
like the ones that preceded it. In that case, the GIN Stroke 
Report for the last point uses the same key as for the pre- 
ceding points: the letter J. 

If the Stroke ends by an operator action (such as removing 
the pen from presence), it is possible that the last xy-report 
does not represent a valid coordinate. In that case, the final 
GIN Stroke Report includes a key field which is the ASCII 
letter O. This notifies the host program that it should not rely 
on the accuracy of the associated xy-report. 

Filling Up the Output Buffer. When using the Stroke graph- 
ics input function, it is easy to digitize points faster than the 

ICI llllliai VCll I OCI H-l II I O l/WI I 00|_/«JI K-lll ly V**ll * <-»l.i wn\/ i i««*|-"-« «.w iw 

the host computer. When this happens, the terminal's out- 
put buffer can overflow. (You may be able to avoid this con- 
dition by using a high baud rate, or by using stroke filtering 
in order to digitize points less frequently.) 

If the terminal's output buffer is full, then the terminal can 
accept no more graphics input data until some of the char- 
acters in that buffer have been sent to the host computer. 
With the buffer full, attempting to enter more points (a) 
causes the current stroke to end, and (b) causes the termi- 
nal to sound its bell. The bell serves to warn the operator to 
pause before digitizing more points. (The pause gives time 
for the terminal to transmit characters to the host, thereby 
freeing memory in the output buffer.) 
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REPORT PORT STATUS 

Sends a Port Status Report to the host or screen. 
Host Syntax 



E cPQ port 



port: integer; specifies the peripheral port whose status is 
to be reported. Valid devices are: 

PO: RS-232 Peripherial Port PO 

P1 : RS-232 Peripherial Port P1 
Defaults: Omitted = Error PQ1 1 

When the REPORT PORT STATUS command is received as 
an escape sequence, the terminal sends a Port Status 
Report for the specified RS-232 peripheral port to the host 
computer. 

When the terminal sends a report to the host, Bypass mode 
is entered. (See ENTER BYPASS MODE.) 

If the port parameter is invalid (neither PO:, nor P1:), then 
the terminal detects a type PQ1 1 error. Nevertheless, it still 
sends a Port Status Report to the host computer. That 
report, however, is abbreviated; its port ID code consists of 
two s p characters, and the port information is omitted. For 
details, see the following description of the Port Status 
Report. 



Port Status Report 

The Port Status Report has the following format: 

EOM-indicator 

signature-character 

port-ID-code 

port-information 

EOM-indicator 

EOM-indicator. An EOM-indicator may be sent at the start 
of the Port Status Report. This optional EOM-indicator is 
provided because of the terminal's "maximum report line 
length" feature. This EOM-indicator is included in the Port 
Status Report only if it is needed to prevent the current 
maximum line length from being exceeded. (See the 
description of the SET REPORT MAX LINE LENGTH com- 
mand for details.) 



An EOM-indicator is included at the beginning of a Port 
Status Report only if both the following conditions are met: 

• At least one character has already been sent on the 
current line (that is, since the last EOM-indicator). 

• If the remainder of the port-status-report could cause the 
current maximum line length to be exceeded. 

Signature-Character. The signature-character is provided for 
easier parsing of the report by the host computer. (If graph- 
ics input is active, the signature character allows the host to 
distinguish this report from GIN reports which are part of a 
GIN report sequence.) The signature character in the Port 
Status Report is the current signature-character for non-GIN 
reports, as set by the mosl recent SET REPORT SIG 
CHARS command. If the current signature-character is N u, 
then it is omitted from the Port Status Report. 

Port-ID-Code. Next comes a two-letter code: PO, P1 , or 
s p s p. This names the RS-232 peripheral port to which the 
Port Status Report pertains. These two characters are sent 
to the host as character-reports. 

A port-ID-code of s p s p indicates that the REPORT PORT 
STATUS command had an invalid port-specifier string, if 
that is the case, then the following port-information param- 
eter is omitted. 

Port Information. The port-information consists of a series 
of int-reports, string-reports, and int-array-reports. These 
contain the current values of the peripheral port's parame- 
ters: baud rate, parity, number of stop bits, etc. 

The device-driver-name string-report that is part of the port- 
information is always ten characters long. 

Final EOM-indicator. The Port Status Report ends with an 
EOM-indicator. This final EOM-indicator is always sent; it 
helps ensure that the host applications program actually 
receives the Port Status Report in a timely manner. (In some 
host operating systems, the user application program does 
not receive a message from the terminal until the terminal 
sends a c r or other end-of-message indicator.) 
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REPORT SEGMENT STATUS 

Causes the terminal to send a Segment Status Report to the 
host. 

Host Syntax 



E cSQ segment-number, 
status-codes 



cC^diCui'tiwi/n/Ci . ■■ ii^^tsi , g|j>gvincg ii i^ o^yi iicm nun ii»"d n i 

the range (-3 to 32767) for which you want information. 
-3 All segments that match the current match- 

ing class 
-2 The default values for segments not yet 

defined 
-1 All segments in the range 1 through 32767 

The crosshair cursor 

i to 32767 A speciiic segment 
Defaults: Omitted = 

status-codes: character array; specifies the kind of informa- 
tion to be returned for the specified segment. Valid array 
characters are: 

A Segment classes 

D Detectability 

H Highlighting mode 

I Image transform parameters 

M Writing mode 

P Pivot point 

S Display priority number 

V Visibility 

a rusinun 

Defaults: Omitted = Empty array 

The REPORT SEGMENT STATUS command causes the 
terminal to send a Segment Status Report to the host 
computer. 

When the terminal sends a report to the host, it enters 
Bypass mode. (See ENTER BYPASS MODE.) 

This command is intended to be issued by the host com- 
puter. It should not be typed in by the operator with the 
terminal in Local mode. 



Segment Status Report 

The Segment Status Report has the following format: 

report-for-one-segment 

terminal-signature-character 

EOM-indicator 

The following paragraphs detail the parts of the report. 

Report-for-One-Segment. Each report-for-one-segment 
describes the attributes for one segment. It may begin with 
an optional EOM-indicator. The EOM-indicator is provided 
because of the terminal's "maximum line length feature". If 
too many characters have been sent on the current line, so 
that sending the remainder of the report-for-one-segment 
would cause the maximum line length to be exceeded, then 
the terminal ends the current line with an EOM indicator. 
The signature-character that follows would then be the first 
character of the next line of text. 



This EOM indicator is sent only if the following conditions 

are met: 

• At least one character has already been sent on this line. 
(That is, at least one character has already been sent 
since the last EOM indicator.) 

• If this report-for-one-segment without the EOM indicator 
would cause the maximum line length to be exceeded. 

• The most recent SET REPORT EOM FREQUENCY 
command specified "more frequently" rather than "less 
frequently". 

Ter minal-Si° nature-Character . The terminal-si^nature- 
character is determined by the most recent SET REPORT 
SIG CHARACTERS command for non-GIN reports. (See the 
description of the SET REPORT SIG CHARACTERS com- 
mand for details.) The terminal-signature-character is pro- 
vided as a convenience for the host routine which parses 
the Segment Status Report; it marks the end of the report. If 
the terminal-signature-character is N u, it is omitted from the 
segment-status-report. 

Final EOM-indicator. After sending the terminal-signature- 
character, the terminal ends the Segment Status Report with 
an EOM indicator. This EOM indicator is always sent; it 
helps to ensure that the host applications program receives 
the preceding characters in a timely manner. (In most host 
operating systems, the user program does not actually 
receive a message from the terminal until the message 
ends with a c r.) 
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The signature character is provided as a convenience for 
the host program's parsing routine. It serves to mark the 
beginning of each report-for-one-segment. The signature 
character is a single ASCII character, determined by the 
most recent SET REPORT SIG CHARACTERS command 
for non-GIN reports. (See the SET REPORTS SIG CHAR- 
ACTERS command for details.) If the signature character is 
N u, it is omitted. 

After the signature character comes an integer report: the 
segment number (or error code) for the particular segment 
whose attributes are being reported. If the character-array 
parameter in the REPORT SEGMENT STATUS command 
was empty, then the segment number is the only item 
reported in the report-for-one-segment. An error cods 
(described later) is subsituted for the segment number if an 
invalid segment number or segment attribute codes, or if 
the segment specified does not exist. 

Following the segment number, each report-for-one-seg- 
ment contains zero or more Segment Attribute Reports. 
There is one Segment Attribute Report for each letter in the 
character-array parameter of the REPORT SEGMENT 
STATUS command. 

Each Segment Attribute Report contains information about 
one of the segment's attributes, and begins with the code 
letter for that attribute. For instance, a Segment Classes 
Report begins with the letter A, a Visibility Report begins 
with the letter V, and a Position Report begins with the 
letter X. 



REPORT SYNTAX MODE 

Sends a Terminal Settings Report that contains the syntax 
mode status to the host. 

Host Syntax 



E c#!0 



This command has the same effect as a REPORT TERM I- 
NAL SETTINGS command issued for the SELECT CODE 
command (as if E clQ%! was sent from the host). See 
REPORT TERMINAL SETTINGS. 

This command is recognized in Ansi, Tek, and VT52 modes. 



REPORT TERMINAL SETTINGS 

Causes the terminal to send a Terminal Settings Report to 
the host computer. 

Host Syntax 



E cIQ inquiry-code 



inquiry-code: integer; a two-character parameter containing 
the two-letter opcode for an escape-sequence command or 
a special two-character inquiry code for other information 
about the terminal. 

This general-purpose inquiry command tells the terminal to 
send a Terminal Settings Report to the host computer. 

When the terminal sends a report to the host, it enters 
Bypass mode. (See the description of the ENTER BYPASS 
MODE command.) 

Besides the opcodes for commands, special inquiry codes 
can be given in the REPORT TERMINAL SETTINGS com- 
mand. These codes are listed in Table 5-10. 



Table 5-10 
SPECIAL INQUIRY CODES 



Code 


Associated Parameter Reports 


?M 


integer-report: available-memory integer-report: 
largest-contiguous-block (The available memory, and the 
size of the largest contiguous block, are reported as a 
number of 16-byte units of memory.) 


?T 


integer-report: model-number-code 


00 


integer-report: standard-firmware-version-number 



Terminal Settings Report 

The Terminal Settings Report has the following format: 

EOM-indicator 

signature-character 

opcode-report 

parameter-report 

EOM-indicator 



5-52 



4107/4109 PROGRAMMERS 



4100-STYLE COMMANDS & REPORTS 
REPORT TERMINAL SETTINGS 



EOM-Indicator. An optional EOM-indicator is provided 
at the start of the terminal-settings-report because of the 
terminal's :: maximum iine length 1 ' feature. (See the 
description of the SET REPORT MAX LINE LENGTH 
command for details.) This EOM-indicator is only sent if 
not sending it would cause the terminal's maximum line 
length to be exceeded. 

Signature-Character. The signature-character (signature 
character) is sent only if it is not N u. This character is the 
current signature-character for non-GIN reports, as set by 
the most recent SET REPORT SIG CHARACTERS com- 
mand. 

Opcode-Report. Next comes the opcode-report, consist- 
ing of two character-reports. The two characters being 
reported are the same two characters which were used 
in the REPORT TERMINAL SETTINGS command; they 
comprise either an opcode for one of ihe terminal's com- 
mands, or else a special inquiry code. 

However, if the REPORT TERMINAL SETTINGS com- 
mand specifies an op code for a command which does 
not exist, or which is not installed in the teminal, then the 
opcode-report is s p s p. 

The special inquiry codes are listed in Table 5-10. For 
each inquiry code, the table also shows the parameter- 
reports which are included in that inquiry code's Terminal 
Settings Report. 

Parameter-Report. The command specified by opcode in 
the opcode-report has in its syntax a number of parame- 
ters. The current values of these parameters are 
returned, in order, in the parameter-reports. 

Each parameter-report is of an appropriate type for the 
parameter being reported. For instance, consider a 
Terminal Settings Report for the terminal's baud rate. 
The SET BAUD RATE command (op code NR) has two 
parameters of type integer. The terminal sends the val- 
ues of integer parameters to the host using the integer- 
report syntax. Therefore, in the corresponding Terminal 
Settings Report, there are two integer-reports. 

For special inquiry codes, use the Parameter Reports 
listed earlier in Table 5-1 0. 



Examples 

Reporting Baud Rates. The REPORT TERMINAL SET- 
TINGS: NR command requests the terminal to send a report 
of its current baud rate settings. (This is because it is the 
SET BAUD RATES command which has the opcode NR.) 

Assume that the terminal is not in Block mode, that its cur- 
rent EOL-string is the single character, c r, and that the 
signature-character tor non-GIN reports \sA. Assume also 
that the terminal is set to transmit and receive at 1200 baud. 
In that case, the report which the terminal sends to the host 
is: 

EOM-indicator (usually omitted) 

signature-character 

opcode-report 

first-baud-rate 

second-baud-rate 

EOM-indicator 



parameter-report: 
parameter-report: 



= A 
NR 

integer-report: 1200 
integer-report: 1 200 

C R 

= ANR! + 0! + c r 

Reporting the Amount of Available Memory. To request a 
report on the amount available memory, the host sends a 
REPORT TERMINAL SETTINGS: ?M command. If the 
signature-character and EOL-string are as in the previous 
example, and if the terminal is not in Block mode, then the 
report which the terminal sends the host is as follows: 

T?r\\A-ivtAifntr\r ti ici tallu nmittoH^ 

iju,.. .,™.^».„i V «w«—..j - ™, 

signature-character 

opcode-report 

available-memory 

largest-block 

EOM-indicator 

= A 

?M 

integer-report: available-memory 
integer-report: largest-block 



parameter-report: 
parameter-report: 
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Exceptions 

For a few commands (or opcodes), the meanings of the 
parameters reported in the Terminal Settings Report differ 
from the meanings of the parameters when sending those 
commands to the terminal. These commands are: 

PROMPT MODE (opcode NM) 
LOCK VIEWING KEYS (opcode RJ) 
SET SURFACE COLOR MAP (opcode TG) 
SET VIEW DISPLAY CLUSTER (opcode RQ) 

PROMPT MODE Command. Prompt mode can be turned 
on with a parameter of 1 or 2. However, the terminal only 
reports whether the Prompt mode is on (1 ) or off (0). 

LOCK VIEWING KEYS Command. This command takes the 
form E cRJ integer. Therefore, a REPORT TERMINAL SET- 
TINGS: RJ command causes the terminal to send a Termi- 
nal Settings Report which has one parameter-report, of the 
integer-report type: 

EOM-indicator 
signature-character 
RJ 
i nteger-report: viewing-key-status 
EOM-indicator. 

In this report, however, the viewing-key-status integer can 
assume more values than just zero and one. It can assume 
values from zero to three. The meanings of these are as 
follows: 

The terminal is in not in Framing mode. (That is, it 
is neither in Zoom mode nor in Pan mode.) More- 
over, the viewing keys are not locked. (This does 
not preclude the entire keyboard's being locked as 
a result of a lock-keyboard command.) 

The terminal is in Zoom mode. 



The terminal is in Pan mode. 

The viewing keys are locked. (Therefore, the termi- 
nal is neither in Zoom mode nor in Pan mode.) 



SET SURFACE COLOR MAP Command. This command 
has the syntax E cTG integer-array. Therefore, a REPORT 
TERMINAL SETTINGS: TG command causes the terminal 
to send to the host a Terminal Settings Report with the fol- 
lowing syntax: 

EOM-indicator 

signature-character 

TG 

n umber-of-surfaces 

color-info 

EOM-indicator 



integer-report: 
integer-array-report: 



Here, the integer-array tells the number of surfaces cur- 
rently defined, while the integer-array-report contains infor- 
mation about the background color mixture, and about the 
color mixtures for each of the color indices on each of the 
surfaces. (This is different from the meaning these parame- 
ters have when they are in SET SURFACE COLOR MAP 
command sent from the host to the terminal.) 

i nteger-array-report : color-info 

= mieger-report.number-of-integer-reports-to-follow 
\r\p\e-xepor\:background-color 

colors-for-one-surface. . . 

colors-for-one-surface 
= integer-report: negative-surface-number 

triple report: color-coordinates-for-one-color-index... 



triple-report = 



[HLS-triple-report] 
{RGB-triple-report} 

[CMY-triple-report] 



HLS-triple-report = 
RGB-triple-report = 
CMY-triple-report = 



integer-report: hue-angle-in-degrees 
integer-report: lightness-percentage 
integer-report: saturation-percentage 

integer-report: red-percentage 
integer-report: green-percentage 
integer-report: blue-percentage 

integer-report: cyan-percentage 
integer-report: magenta-percentage 
integer-report: blue-percentage 



The HLS, RGB, or CMY color coordinate system is used in 
the report, depending on which color specifying mode was 
selected by the most recent SET COLOR MODE command. 
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Suppose, for instance, that HLS color coordinates are being 
used. (This is the default when the terminal is turned on.) 
Consider the following integer-array-report: 



i nteger-array-report : color-info = 



integer 
integer- 
integer- 
integer- 
integer- 
integer- 
integer- 
integer- 



•report: 1 7 

report: 

report: 

■report: 

report: -1 

report: 120 

report: 50 

report: 100 



int£iriQr_r*ir*/-\r+- O 



integer- 
integer- 
integer- 
integer- 
integer- 
integer- 
integer- 
integer- 
integer- 



•report: 180 
■report: 50 
report: 100 
report: 240 
report: 50 
report: 100 
report: 
report: 100 
report: 



Here, the first integer-report says that there are 1 7 integer- 
reports to follow in the integer-array-report. 

The next three integer-reports say that the background 
color is black (hue zero degrees, lightness zero, saturation 
zero). 

The following four integer-reports carry the numbers -1 , 
1 20, 50, 1 00. Thus, on surface one, color index one is dis- 
played as a red color (hue 120 degrees, lightness 50, satu- 
ration 1 00). Since only one set of three coordinates follows 

the —1 there mi i<*t hp nnlv nnp nnn.70rn pnlnr inHoy fnr that 

-- "*- "5 — ■— ■ — ...——-—.» v.-j w. .v ■ >\*i ■ a_vi w V*WI VI II 1W vA lul nidi 

surface. In other words, surface one has only one bit plane 
assigned to it. 

Likewise, the next ten integer-reports carry the numbers -2, 
180, 50, 100, 240, 50, 100, 0, 100, 0. These give three sets 
of color coordinates for surface number two. On that sur- 
face, color index one is displayed as yellow (hue 180, light- 
ness 50, saturation 1 00), color index two as green (hue 240, 
lightness 50, saturation 100), and color index three as white 
(hue 0, lightness 1 00, saturation 0). Since three sets of color 
coordinates are reported for surface two, that surface must 
have two bit planes assigned to it. 



SET VIEW DISPLAY CLUSTER Command. This command 
has the syntax E cRQ integer-array. Therefore, the command 
E clQRQ causes the terminal to send to the host a Terminal 
Settings Report with the following syntax: 

EOM-indicator 

signature-character 

RQ 

integer-array-report 

EOM-indicator 

Here, the integer-array-report tells how views are grouped 
into view display clusters. For the purposes of this report, 
the clusters are assigned numbers. The first number in the 
int-array-report tells to which cluster, if any, view number 
one is assigned. Likewise, the second number in the array 
tells to which cluster view two is assigned, — and so on. if a 
view has not been assigned to any display cluster, then 
"cluster number zero" is reported for that view. 

Suppose, for instance, that the signature character for non- 
GIN reports is the tilde ( ~ ), and that the host has issued the 
character sequence, E clQRQ. (This is a REPORT TERMI- 
NAL SETTINGS command which inquires about the view 
display cluster settings.) One possible response from the 
terminal would be: 

~ RQ s p s p6 s p s p1 s p s p1 s p s p1 s p s pO s p s p2 s p s p2 c r 

Here, the tilde ( - ) is the signature-character, the characters 
RQ signify that the report is for the RQ opcode, and the final 
c r is the EOM-indicator. The other characters comprise an 
int-array-report, as follows: 

s p s p6 = int-report: 6 (The array has six items) 

-p s p1 = int-report: 1 (View 1 is in Display Cluster 1) 

s p s p1 = int-report: 1 (View 2 is in Display Cluster 1) 

s p s p1 = int-report: 1 (View 3 is in Display Cluster 1) 

s p s p0 = int-report: (View 4 is not in any display 
cluster) 

s p s p2 = int-report: 2 (View 5 is in Display Cluster 2) 

s p s p2 = int-report: 2 (View 6 is in Display Cluster 2) 

Thus, the Terminal Settings Report tells the host these 
things: 

• The highest-numbered view which is in a view display 
cluster is view number six. 

• Views one, two, and three are in the same display clus- 
ter. 

• Views five and six are in the same display 
cluster. 

• View four is not in any view display cluster. 
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REPORT 4010 STATUS 

Causes the terminal to emulate a 4010-style terminal by 
sending a 4010 Status Report. 

Host Syntax 



Bits 4 and 5 indicate the No Linear Interpolation (NOLI) and 
Graph mode status as follows: 



This command also terminates 4010 GIN mode and returns 
the terminal to Alpha mode. 

4010 Status Report 

This report is sent in response to REPORT 401 STATUS. 
The report has two forms, depending on whether the termi- 
nal is in GIN mode when the command is sent. 

If the terminal is not in GIN mode, the report has the follow- 
ing format: 

terminal-status 

alpha-cursor-position 

EOM-indicator 

If the terminal is in GIN mode, the report has the following 
format: 

graphics-cursor-position 
EOM-indicator 

The following paragraphs detail the parts of the report. 

Terminal-Status. The status of the terminal is encoded into 
the seven bits of an ASCII character, as follows: 



b7 


b6 


b5 


b4 b3 


b2 


b1 





1 


HCU 


NOLI GRAPH 





1 



Bits 7 and 6 are always set to and 1 , respectively; Bits 2 
and 1 are also set to and 1 , respectively. 

The HCU (Bit 5) is set to if a hardcopy unit is attached to 
the terminal and is ready to accept a copy request; other- 
wise this bit is set to 1. 



NOLI 


GRAPH 





The terminal is in Marker mode 





1 The terminal is in Alpha mode 


1 


The terminal is in Vector mode 


1 


1 This combination does not occur 



For example, if the terminal (1 ) has a hardcopy unit 
attached, (2) is ready for a hardcopy command, and (3) is in 
Vector mode, the bits sent are: 

10 10 1 

The corresponding character on the ASCII chart is the clos- 
ing parenthesis — ) — which would be transmitted as the 
status byte. 

Alpha-Cursor-Position and Graphics-Cursor-Position. The 
terminal reports both cursor positions in the following for- 
mat: 

Hi-X 
Lo-X 
Hi-Y 
Lo-Y 

The Hi-X, Lo-X, Hi-Y,and Lo-Y characters follow the same 
general coding method described under the heading XY- 
Coordinates in Host Syntax earlier in this section, with two 
important differences: 

• The first two bits of each character are set to 01 . 

• Only the ten most significant bits are included in the 

report. 

Figure 5-9 illustrates the binary process of decoding the 
ASCII characters that report that the cursor is at 
(1 000,2000). To report these coordinates the terminal sends 
the following characters: 

':/4 



5-56 



4107/4109 PROGRAMMERS 



4100-STYLE COMMANDS & REPORTS 

RESET 



The host program must convert each character to equiva- 
lent numbers (ASCI! Decimal Equivalents). Figure 5-9 
shows the binary representation of these numbers. The first 
two bits are always 01 , confirming that these are report 
characters. To get rid of the 01 prefix, subtract decimal 32 
from each number (Hi-X = 39 - 32 = 7). The remaining 
values combine to form the two decimal xy-coordinates: 

• Multiply the Hi-X value by decimal 1 28 and save the 
product: (7 * 128 = 896). 

• Multiply the Lo-X value by decimal 4 and save the 

nrnHi i^t' tOd * A — •\(\A\ 

• Add the products, yielding the x-coordinate: (896 + 
104 = 1000). 

• Repeat the previous three steps with the y-values to find 
the y-coordinate. 

Notice that the last two bits of the cursor position are not 
reported and can be assumed to be (00). 

EOM-Indkator. The EOM (End Of Message) character 
may be sent to show that the 401 Status Report message 
is complete. However, it is not an essential part of the 
message. 



RESET 

Returns the terminal to its power-up condition. 
Host Syntax 



E cKV 



Setup Syntax 



The RESET command initializes the terminal to its power- 
up condition. It is equivalent to pressing the RESET button, 
or to turning the terminal off and then turning it on again. 

NOTE 

The terminal takes several seconds to execute the 
RESET command. During that time, it is perform- 
ing its power-up reset and self-test routines, and 
cannot process data coming from the host. 

Therefore, if you issue a RESET command from 
the host, you should wait at least 15 seconds before 
sending other commands or data to the terminal. 



Cursor Report = ':/4 



Hi-X 

Lo-X 

Hi-Y 

Lo-Y 

X-Coordinate = decimal 1000 
= binary 00111 11010 00 

Hi-X Lo-X 



01 


00111 


i 11010 | 


01 


01111 




[01 


10100 



Not 
Used 



ASCII 




Character 


ADE 


/ 


39 




58 


1 


47 


4 


52 



Y-Coordinate = decimal 2000 

= binary 01111 10100 00 

Hi-Y Lo-Y Not 
Used 



Figure 5-9. The Cursor Position Report. 
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RUNLENGTH WRITE 

Loads color indices into the pixel viewport. 
Host Syntax 



E cRL runcode-array 



Setup Syntax 



PXRUNLENGTHWRITE runcode-array 



runcode-array: integer-array; uses runcodes to write color 
indices to the pixel viewport. Each runcode can range from 
to 65535. 
Defaults: Omitted = Empty Array 

Starting at the current pixel beam position in the pixel view- 
port, the terminal sets the specified number of pixels to the 
specified color index for each runcode in the array. The 
color indices are written into raster memory using the ALU 
mode and surface specified in the most recent BEGIN 
PIXEL OPERATIONS command. As each pixel is assigned 
a color index, the pixel beam position moves so that it points 
at the next pixel to the right on the same line. On encounter- 
ing the right edge of the pixel viewport, the pixel beam posi- 
tion wraps around to point to the pixel at the left edge of the 
pixel viewport on the line below; however, if the pixel beam 
position is on the bottom line, the beam position wraps 
around to the left edge of the top line of the pixel viewport. 
When all the pixels for a given runcode have been loaded 
with the specified color index, the process is repeated for 
the next runcode in the integer array. 

Each runcode includes two numbers packed together: one 
is a color index, and the other is the number of pixels which 
are to be set to that color index. The runcodes are packed 
using the form 

Runcode = number-of-pixels * 2" + color-index 

where n = number-of-bits-per-pixel 

The bits-per-pixel parameter from the most recent BEGIN 
PIXEL OPERATIONS command supplies the value for n 
unless that parameter is 6; then the value of n is 4. 



If the number of bits per pixel is greater than the number of 
bit planes on the current surface, the surface receives only 
the most significant bits of each color index sent. For 
instance, if the number of bits per pixel is 3 and the current 
surface has only two bit planes, a color index with a binary 
value of 1 1 is written to the current surface as 1 1 . In the 
case of six bits per pixel, if color index 8 (binary 001000) is 
sent to a surface that has three bit planes, the bits 1 000 are 
sent and written to the surface as 1 00. 

SAVE NONVOLATILE PARAMETERS 

Saves nonvolatile parameters that have been altered. 
Host Syntax 



E cKU 



Setup Syntax 



NVSAVE 



This command causes the terminal to write to its nonvolatile 
memory all parameters that have been changed since the 
last SAVE NONVOLATILE PARAMETERS command was 
issued. The values of those parameters are restored at 
power-up and are referred to in this manual as the Power- 
Up Defaults. 

Nonvolatile memory means memory that is retained after 
the terminal is turned off. Parameters that are saved in 
nonvolatile memory are referred to in this manual as saved 
in memory. 

This command saves only parameters that have changed 
since the last time this command was issued. 

Each byte of nonvolatile memory has a lifetime of about 
1 0,000 writes. If you attempt to write to nonvolatile memory 
after that, the terminal might display an error message 
(depending on the SET ERROR THRESHOLD LEVEL set- 
ting) that states that there is a "nonvolatile hardware error." 
When that occurs, parameters are reset to factory default 
the next time the terminal is powered up. 
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SELECT CODE 

Causes the terminal to recognize Ansi, Tek, or VT52 mode 
command syntax. Also used to select Edit mode. 

Host Syntax 



E c%! syntax 



Setup Syntax 



CODE syntax 



Host 


Setup 





TEK 


1 


ANSI 


2 


EDIT 


3 


VT52 



syntax: integer; (keyword in Setup syntax); selects the fol- 
lowing modes for Host or Setup. 



Selects Tek mode syntax 
Selects Ansi mode syntax 
Selects Ansi mode syntax for Edit mode 
Selects VT52 mode syntax 
Defaults: Factory = (Tek mode) 

Power-Up = Saved in memory 

Omitted = (Tek mode) 

The syntax of Tek, Ansi, and VT52 mode commands are not 
compatible. If you are using commands from one mode and 
want to execute one or more commands from another 
mode, you must issue the SELECT CODE command with 
the appropriate parameter. 

In Ansi mode, the terminal: 

• Recognizes Ansi mode commands from the host 

In Tek mode, the terminal: 

• Recognizes 41 00-style commands from the host 

In Edit mode, the terminal: 

• Recognizes Ansi mode commands from the host 

• Sets Origin mode to Absolute 

• Sets dialog area and dialog buffer to 24 lines 

• Makes the dialog area visible 

• Defines a scrolling region of 24 lines 

• Sets Insert/Replace mode to Replace 

• Disables all programmed keys 

In VT52 mode, the terminal: 

• Recognizes VT52-style commands from the host 



SELECT FILL PATTERN 

Specifies the fill pattern for subsequent panels. 
Host Syntax 



E cMP fill-pattern-number 



Setup Syntax 



i-ii_l-I-mi i cniN riii-pauem-riUmuer 



fill-pattern-number: integer; must be in the range -15 

through 174: 

Fill a panel with a solid color indicated by 

the negative value of a color index (for 

example, -3 means fill with color index 3's 

coior) 

Specify predefined patterns 

Are invalid and generate an error 

Specify predefined dither patterns 



-15 — 



1—16 
17 — 49 
50—174 



Defaults: Factory = -1 
Power-Up = -1 
Omitted = 

For example, here's how you would select Fill Pattern 1 6 
(encoded as A0) in Host Syntax: 

E cMPA0 

Refer to the appendix in the Operators Manual that contains 
examples of the fill patterns associated with the fill pattern 
numbers. 
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SELECT HARDCOPY INTERFACE 

Selects the copier type to be used in the HARDCOPY 
command. 

Host Syntax 



E cQD copier-type 



Setup Syntax 



HCINTERFACE copier-type 



copier-type: integer; use one of the following: 

Selects a monochrome printer 

1 or 2 Selects the TEKTRONIX 4695 Color Copier 
Defaults: Factory = 2 

Power-Up = Saved in memory 
Omitted = 

The monochrome selection is for compatibility with black- 
and-white printers that use a parallel interface. Selecting a 
monochrome copy type allows only regular-sized dialog 
copies. 



SELECT VIEW 

Specifies which view will be the current view. 
Host Syntax 



E cRC view-number 



Setup Syntax 



VSELECT view-number 



view-numoer: integer; specifies tne view to De selected. 
Valid values for view-number are: 

-1 The next lower-numbered view 

The next higher-numbered view 

1—64 A specific view 
Defaults: Factory = 1 
Power-Up = 1 
Omitted = 

A view is defined by a set of viewing parameters and (possi- 
bly) a set of visible segments. There may be up to 64 views 
defined and each one may be independent of the others. 
Only one view can be selected to be current at a time. All 
actions, such as unretained graphics, segments made 
visible, renew commands, etc., go into this current view. 
When a new view is designated as current, the attributes of 
the previous view are remembered until the next time that 
view is selected. 

If the view has never been selected before, a new view (with 
the specified view number) is created. 

Creating a New View. When a new view is created in this 
manner, the view's parameters are set as follows: 

Window: The window for the new view is the same as 
that for the previous view; that is, it has the 
same lower-left and upper-right corners in 
terminal space. 

Viewport: The viewport for the new view is on the 

same surface, and has the same lower-left 
and upper right corners, as the viewport for 
the previous view. 
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Surface: The surface on which the viewport is dis- 
played is the same as that for the previous 
view. (It can be changed with the SET 
VIEW ATTRIBUTES command.) 

Segments: All segments that already exist remain in 
existence. However, none of these seg- 
ments is visible in the new view. (Segment 
visibility applies only to a particular view; 
see the SET SEGMENT VISIBILITY 
command.) 

Indices: The new view's erase index and border 
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vious view. (These indices, and the surface 
number, can be changed with a SET VIEW 
ATTRIBUTES command.) 

Border: The visibility of the new view's border is the 

same as for the previous view. (It can be 
changed with a SET BORDER VISIBILITY 
command or the BORDER key.) 

Other View Numbers. Specifying View causes the termi- 
nal to select the next higher-numbered view of the existing 
numbered views. If there is no higher-numbered view in 
existence, then the lowest-numbered view is selected. This 
method of selecting the next view is equivalent to pressing 
the NEXTVIEW key, except that the view's border does not 
blink. 

Specifying View -1 selects the next lower-numbered view of 
the existing numbered views. If no such lower-numbered 
view exists, then the highest-numbered view is selected. 
This method is equivalent to pressing CTRL NEXTVIEW, 
except that the view's border does not blink. 

Default View. The default view, which is created at power- 
up (or when a DELETE VIEW command with -1 is issued), 
has these attributes: 



View number: 
Window: 

Viewport: 

Surface number: 

Border: 

Graphics beam position: 

Wipe Index: 



1 

x = Otox = 4095, 

y = Otoy = 3136 

x = 4095, y = 3071 

1 

invisible 

(0,3071) 





SET ALPHA CURSOR INDICES 

Assigns specified coior indices to the alpha cursor. 
Host Syntax 



E cTD first-index, 
second-index 



Setup Syntax 



ACURSOR first-index, 

second-index 



first-index: integer; specifies the first color for the alpha 
cursor; must be in the range to 65535. The values 
through 7 correspond to a color index; a value greater than 
7 sets first-index to 7. 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = 

second-index: integer; specifies the second color for the 
alpha cursor; must be in the range to 65535. The values 
to 7 correspond to a color index. Values greater than 7 set 
second-index to 7. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

The alpha cursor appears on the screen where the next 
alphanumeric character will be displayed. If the second- 
index is is a different color than for the first-index, the cursor 
blinks between the two colors. If the two indices are the 
same, the cursor does not blink. 

The dialog area and the graphics area each have their own 
set of color indices. When the dialog area is enabled, the 
alpha cursor indices refer to dialog area indices. When the 
dialog area is disabled, the alpha cursor indices refer to 
graphics area indices. 
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SET ALPHATEXT FONT 

Selects font to be used for alphatext. 
Host Syntax 



E c font-code 



font-code: small integer; the s icharacter selects the GO 
character set, and s o selects the G1 character set. Regard- 
less of the alphtext font selected, in Setup mode, the termi- 
nal uses the ASCII font. 
Defaults: Power-Up = GO character set 

SET BACKGROUND COLOR 

Sets the color of the background surface which is behind all 
of the transparent writing surfaces. 

Host Syntax 



E cTB first-color-coordinate, 
second-color-coordinate, 
third-color-coordinate 



Setup Syntax 



CBACKGROUND first-color-coordinate, 

second-color-coordinate, 
third-color-coordinate 



first-color-coordinate: integer; specifies a color coordinate 
(H, R, or C) depending on the color-specifying-mode in the 
most recent SET COLOR MODE command. The valid range 
of parameter values for each color coordinate system is: 

HLS -32768 to 32767 

RGB to 100 

CMY to 100 
Defaults: Factory = 
Power-Up = 
Omitted = 



second-color-coordinate integer; specifies a color coordi- 
nate (L, G, or M) depending on the color-specifying-mode 
in the most recent SET COLOR MODE command. The 
valid range of parameter values for each color coordinate 
system is: 



HLS 
RGB 
CMY 
Defaults: 



to 100 

to 100 

0to100 
Factory 
Power-Up = 
Omitted = 



= 



third-color-coordinate integer; specifies a color coordinate 
(S, B, or Y) depending on the color-specifying-mode in the 
most recent SET COLOR MODE command. The valid range 
of parameter values for each color coordinate system is: 

HLS 0to100,or1000to1100 

RGB 0to100, or1000to1100 

CMY 0to100, or1000toH00 
Defaults: Factory = 
Power-Up = 
Omitted = 

The three color coordinates are either HLS, RGB, or CMY 
according to the color-specifying-mode in the most recent 
SET COLOR MODE command. The SET SURFACE 
COLOR MAP command can also be used to set the back- 
ground color. 

You can specify a blinking color by adding 1000 to the value 
of the third-color-coordinate parameter. The color blinks by 
alternating between black and the specified color at a rate 
of (0.75 sec on, 0.75 sec off). For example, in HLS mode a 
normal red background is indicated by (120, 50, 100), and a 
blinking red background is given by (120, 50, 1100). 

NOTE 

If you specify a SUBTRACTIVE overlay mode in 
the SET COLOR MODE command, then you 
should also specify a background color of white (or 
some other light color) with the SETBACK- 
GROUND COLOR command. 
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SET BACKGROUND INDICES 

Specifies the coior indices for the character backgrounds of 
string precision graphtext (and alphatext outside the dialog 
area); also specifies the color index used for the gaps in 
dashed lines. 

Host Syntax 



E cMB text-background-index 
dash-gap-index 



Setup Syntax 



BACKINDICES text-background-index 
dash-gap-index 



text-background-index: integer; specifies the background 
index for string precision graphtext and alphatext which is 
not displayed in the dialog area. Must be in the range -2 
through 32767. 

-2 Specifies the wipe index for the current 

viewport 
-1 Leaves the character background pixels 

unchanged 
— 32767 Specifies a particular color index 
Defaults: Factory = -1 

Power-Up = Agrees with mode saved in memory 
for SET GRAPHICS AREA WRIT- 
ING MODE. (Overstrike mode 
equals -2, Replace mode equals -1 .] 
Omitted = 



dash-gap-index: integer; determines the color index for the 
gaps in dashed lines. Must be in the range -2 to 32767. 
-2 Specifies the wipe index for the current 

viewport 
-1 Leaves the line-gap pixels unchanged 

— 32767 Specifies a particular color index 
Defaults: Factory = -1 
Power-Up = -1 
Omitted = 

Specifying -2 for the text-background-index is like specify- 
ing Replace mode in the SET GRAPHICS AREA WRITING 
MODE command. Specifying -i for the text-background- 
index is like specifying Overstrike mode in the SET GRAPH- 
ICS AREA WRITING MODE command. 

NOTE 

The SET GRAPHICS AREA WRITING MODE 
and SET BACKGROUND INDICES commands 
both affect how alphatext is displayed in the graph- 
ics area. Thus, each of these commands supersedes 
the effect of the other. 
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SET BAUD RATES 

Sets the terminal's transmit and receive baud rates. 
Host Syntax 



E cNR transmit-data-rate 
receive-data-rate 



Setup Syntax 



BAUDRATE transmit-data-rate 
receive-data-rate 



transmit-data-rate: integer; the baud rate at which the termi- 
nal sends data to the host. Valid values are 1 (which means 
"external clock"), 75, 1 1 0, 1 34, 1 50, 300, 600, 1 200, 1 800, 
2400, 4800, 9600, 19200, and 38400. 
Defaults: Factory = 2400 

Power-Up = Saved in memory 

Omitted = Error 

receive-data-rate: integer; the baud rate at which the termi- 
nal expects to receive data from the host. Valid values are 
the same as for transmit-data-rate with the addition of 0, 
which means "same as the transmit rate." 
Defaults: Factory = 2400 

Power-Up = Saved in memory 

Omitted = Same as transmit-baud-rate 

The transmit and receive parameters must be the same if 
you set the baud rate to 38400; otherwise the transmit and 
receive rates do not need to be the same. 



SET BORDER VISIBILITY 

Controls the visibility of a border drawn around the current 
view's viewport. 

Host Syntax 



E cRE border-visibility-mode 



Setup Syntax 



BORDER border-visibility-mode 



border-visibility-mode: integer; specifies whether the bor- 
der of the current view is visible or invisible. Must be chosen 
from the following: 

Invisible 

1 Visible 

2 Toggles the border visibility (if visible, it becomes 
invisible; if invisible, it becomes visible) 

Defaults: Factory = 
Power-Up = 
Omitted = 

The border is drawn as a solid line, just within the viewport. 
It is drawn in the color index specified by the SET VIEW 
ATTRIBUTES command for that view. (If no SET VIEW 
ATTRIBUTES command has been issued, the border is 
drawn with the highest possible color index for the surface 
on which the viewport appears.) 

The border is always drawn in Replace mode (ALU mode 
1 1) so that it overwrites the pixels below it. The border is 
removed by writing over the border, again in Replace mode, 
with the background wipe index for the viewport. Thus, 
turning the border on and off erases any pixels on the bor- 
der of the viewport. (For a description of ALU mode 1 1 , see 
the BEGIN PIXEL OPERATIONS command. For a descrip- 
tion of the background wipe index, see SET VIEW 
ATTRIBUTES.) 
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This description of the "border-visibility-mode" parameter 
replaces the one in the right column of p. 5-64: 



border-visibility-mode: integer (keyword in Setup syntax); 
specifies whether the border of the current view is visible or 
invisible. Must be chosen from the following: 
Host Setup 

no Invisible 

1 yes Visible 

2 toggle Toggles the border visibility (if visible, it 

becomes invisible; if invisible, it becomes 
visible) 
Defaults: Factory = 
Power-Up = 
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SET BREAK TIME 



SET BYPASS CANCEL CHARACTER 



Sets the duration (in milliseconds) of the break signal the 
terminal sends when you press the Break key. 

Host Syntax 



E cNK break-time 



Specifies the character that causes the terminal to leave 
Bypass mode. 

Host Syntax 



E cNU bypass-cancel-character 



Setup Syntax 



BREAKTIME break-time 



Setup Syntax 



BYPASSCANCEL bypass-cancel-character 



breaktime: integer; indicates the length of the break signal 
in milliseconds; must be in the range through 65535. A 
value of causes no break signal to be sent. 
Defaults: Factory = 200 

Power-Up = Saved in memory 

Omitted = 



bypass-cancel-character, small integer (in the range from 
through 1 27); indicates the ADE value of the character that 
cancels Bypass mode; in Setup syntax, you can specify an 
ADE value or enter the corresponding ASCII character. 
Defaults: Factory = 10 ( l f) 

Power-Up = Saved in memory 

Omitted = (do not go into Bypass mode) 



The bypass cancel character should be set to the last char- 
acter sent by the host when it echoes a line of text to the 
terminal. 

In Setup mode, to specify an ADE value in the range 
through 9, precede the digit with 0. For example, indicate h t 
(ADE 9) as 09. The single digits through 9 indicate the 
digit characters (ADE 48 through ADE 57). 

See the Communications section for an explanation of the 
terminal's Bypass mode. 
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SET CHARACTER PATH 

Specifies the direction to move after writing each graphtext 
character. 

Host Syntax 



E cMN direction 



Setup Syntax 



GTPATH direction 



direction: integer (keyword in Setup syntax); indicates 
which direction graphtext characters are written. Table 5-1 1 
defines each value's effect. 
Default: Factory = (right) 

Power-Up = (right) 

Omitted = (right) 



Table 5-11 
CHARACTER PATH SETTINGS 



Integer 


Setup 
Keyword 


Meaning 





right 


Use path equal to rotation angle 


1 


left 


Use path 180° greater than rotation angle 


2 


up 


Use path 90° greater than rotation angle 


3 


down 


Use path 90° less than rotation angle 



Figure 5-1 shows how the string "ABC" is displayed using 
the four different directions for character path. Note that 
graphtext rotation is 0° for all examples in Figure 5-10. 

The keywords (right, up, left, and down) refer to character 
path after orientation with the rotation angle specified in 
SET GRAPHTEXT ROTATION. Table 5-1 1 gives explicit 
definitions of the keywords. 



Integer 
Setting 




Setup 
Parameter 


Example 


Path Relation 
to Rotation Angle 









RIGHT 




xABC, 


Same 


1 




LEFT 




*CBA X 


+ 180° 


2 




UP 




* 

C 


+ 90° 










B 














A 

X 






3 




DOWN 




X 

A 


-90° 










B 














C 

* 






Note: Graphtext 


is "ABC" 


with rotation = 0° in all examples. 


xis 


graphics position before graphtext is displayed. 




*is 


updated graphics 


position after graphtext 


s displayed. 
















4526-1 7B 



Figure 5-10. Character Path Settings. 
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SET COLOR MODE 

Sets the color mode for the terminal. 
Host Syntax 



E cTM color-specifying-mode 
color-overlay-mode 
gray-mode 



Setup Syntax 



CMODE color-specifying-mode 
color-overlay-mode 
gray-mode 



color-specifying-mode: integer; specifies the color coordi- 
nate system used to mix coiors in subsequent coior opera- 
tions. Valid values are: 

No change 

1 RGB (red, green, blue) 

2 CMY (cyan, magenta, yellow) 

3 HLS (hue, lightness, saturation) 
Defaults: Factory = 3 (HLS) 

Power-Up = 3 

Omitted = (Or no change) 

color-overlay-mode: integer; specifies the mode used when 
colors are placed on top of each other. Valid values are: 

No change 

1 Opaque 

2 Subtractive 

3 Additive 
Defaults: Factory 

Power-Up 
Omitted 



= 1 (Opaque) 

= 1 

= (Or no change) 



gray-mode: integer; specifies whether operation is color or 
black and white. Valid values are: 

No change 

1 Normal color operation 
Defaults: Factory = 1 (Color mode) 

Power-Up = 1 (Color mode) 
Omitted = (Or no change) 



This command sets color mode parameters for the terminal. 
A color raster terminal generates colors on the display 
screen by mixing the three primary colors: red. green, and 
blue. However, the terminal allows the user to specify colors 
in one of three color systems: HLS (hue, lightness, and 
saturation); RBG (red, green, and blue); or CMY (cyan, 
magenta, and yellow). The SET COLOR MODE command 
selects one of these coordinate models. 

HLS System. Hue is the angle formed by rotating a vector 
around a 360 degree color axis as shown in the HLS System 

/~v*/^« f^n™ n o+ n> -+;» n *>.;+u n u, .« «* n o nn ^j ■-„*., ,+;«.. ;»* « 
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counterclockwise direction, ° corresponds to blue, 120 ° 
to red and 240 ° to green, with intermediate shades corres- 
ponding to intermediate 
rotations. 

Lightness is the position of a vector along the axis of the 
cone. A lightness of 0% is black with dark shades of gray 
increasing toward lighter tones until white is reached at 
100%. 

Saturation is represented by a radial vector formed perpen- 
dicular to the cone axis. For example, one could specify 
saturation for a hue of ° (blue) and Lightness 50% (middle 
gray) by starting at a saturation varing from to 1 00%. 0% 
would produce a light blue gray, then pass thru a medium 
blue at 50% ending up at dark blue for a final value of 
100%. 

RGB System. This system, which is also called the additive 
color system, defines colors as mixtures of three additive 
color primaries: red, green, and blue. You control the overall 
brightness of the coior with the brightness of the primaries 
you use. You specify colors in the RBG system as integer 
percentages from 0% to 100%. For example, adding RGB 
as (100,0,100) produces magenta. 

CMY System. This system, which is also called the subtrac- 
tive color system, defines colors as mixtures of the three 
subtractive primaries: cyan, magenta, and yellow. In the 
CMY system, adding a greater percentage of a primary 
reduces the lightness of the displayed color. You specify 
colors in the CMY system as integer percentages from 0% 
to 100%. For example, combining CMY as (100,0,100) 
produces the color green. 
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Color Overlay Mode. The color-overlay-mode parameter 
specifies the behavior of the terminal's writing surfaces. If 
this parameter is zero, the color overlay mode is left 
unchanged. 

In Opaque mode (parameter of 1 ), pictures drawn on a 
surface obscure pictures drawn on surfaces behind them. 
When the terminal is turned on, it powers up in Opaque 
mode. 

In Subtractive mode (parameter of 2), pictures are drawn as 
if using transparent inks. The terminal behaves like a "light 
table," in which transparent overlays are placed on top of a 
diffusing light source. 

NOTE 

Ifyouspecify the SUBTRACTIVE color-overlay- 
mode in the SET COLOR MODE command, then 
you should also specify a background color of 
white (or some other light color) with the SET 
BACKGROUND COLOR command. 

In Additive mode (parameter of 3), the images drawn on 
different surfaces act as if their colored inks were comprised 
of many small point light sources. Where colors on one 
surface overlap with colors on another surface, the light 
from the two surfaces' light sources combine. For instance, 
a red object on one surface and a green object on another 
surface would combine to produce a yellow color where the 
two objects overlap. 



SET COPY SIZE 

Sets the copy size. 
Host Syntax 



E cQA size 



Setup Syntax 



HCSIZE size 



size: integer; use one or the roiiowing: 

Selects default copy size (8V2X1 1 ") 

1 Selects smaller copy size 
Defaults: Factory = 

Power-Up = 
Omitted = 

If you select the smaller size for a screen copy, the copy is 
one-half the default size. However, if you select the smaller 
size for a dialog area copy, the copy is smaller than the 
default size but larger than one-half the default size. Refer 
to the HARDCOPY command for additional information 
about screen and dialog area copies. 

The smaller size produces a faster copy, but only in eight 
colors: black, white, red, green, blue, cyan, magenta, and 
yellow. 

The smaller copy size also allows you to copy 1 32 columns 
on the same line. If, however, the default copy size is cho- 
sen and Column mode is set to 1 32, the extra 52 columns 
are wrapped to the next line. 

If you are using a monochrome copier, selecting the smaller 
copy size does not produce a smaller copy. 
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SET CURRENT MATCHING CLASS 

Establishes the inclusion and exclusion sets used in match- 
ing operations. 

Host Syntax 



E cSL inclusion-set 
exclusion-set 



Setup Syntax 



SGMATCHINGCLASS inclusion-set 
exclusion-set 



inclusion-set: integer array; specifies the set of classes used 
in the inclusion part of a matching operation. Valid integer 
values are: 

-1 All attributes 

1—64 A specific attribute 

Defaults: Factory = Empty array 
Power-Up = Empty array 
Omitted = Empty array 

exclusion-set: integer array; specifies the set of classes 
used in the exclusion part of a matching operation. Valid 
values are: 

-1 All attributes 

1—64 A specific attribute 

Defaults: Factory = Empty array 
Power-Up = Empty array 
Omitted = Empty array 

A matching operation is done for each defined segment 
(except segment 0, the crosshair cursor) when Segment -3 
is specified in a segment command. 

The matching operation works this way: 



IF 



AND 



The intersection of a segment's class set with the 
inclusion set equals the inclusion set 



The intersection of a segment's class set with the 
exclusion set equals the empty set 

THEN The command is performed on the segment. 

Otherwise, the command is not performed on the segment. 



The elements in the inclusion-set and exclusion-set parame- 
ters are classes that the user includes or excludes in the 
current matching class. There are 64 possible classes (1 
through 64), and all combinations are valid. If you assign -1 
as a member of either set, that set includes all classes. 

See the discussion of segment classes in the section titled 
The Graphics Terminal. 



SET DiALOG AREA BUFFER SIZE 

Specifies the maximum number iines of text stored in the 
dialog area buffer. 



Host Syntax 



E cLB number-of-lines 



Setup Syntax 



DABUFFER number-of-lines 



number-of-lines: integer; indicates the maximum number 

lines in the dialog buffer; must be in the range 2 though 

32767. 

Defaults: Factory = 49 

Power-Up = Saved in memory 

Omitted = Error LB11 

This command takes effect as soon as it is given. The dialog 
area buffer is changed to the size specified, and the cursor 
returns to the home position in the dialog area. For a more 
detailed description of the dialog area, see The Graphics 
Terminal section of this manual. 

If you set size of the dialog buffer to less than the size of the 
dialog area, the size of the dialog area is automatically 
changed to match the size of the of dialog buffer. 

The Ansi mode commands TEKOM and TEKSTBM can set 
a nonscrolling dialog area. When this is the case, if you 
specicfy a dialog buffer larger than the screen size (32 
lines), the top and bottom margins are reset to lines 1 and 
32. If Origin mode is Absolute and you specify a dialog 
buffer larger than the screen size, the Origin mode is set to 
Relative. 
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SET DIALOG AREA COLOR MAP 

Specifies the color assigned to one or more color indices in 
the dialog area. 

Host Syntax 



E cTF color-mixture . 



Setup Syntax 



DACMAP color-mixture . 



color-mixture: integer array; consists of groups of four inte- 
gers {quadruples). Each quadruple specifies a color index 
(valid range through 7) and the HLS coordinates of the 
color being assigned to that index: hue (a valid range of - 
32768 through 32767), lightness (a valid range of through 
1 00), and saturation (a valid range of through 100). Unlike 
other integer arrays in Setup syntax, the first element must 
specify the number of following elements. 
Defaults: Factory = See Table 5-1 2 

Power-Up = Saved in memory 
Omitted = No change to color map 

When specifying a color in most commands, you use a color 
index, which is an integer in the range through 7. SET 
DIALOG AREA COLOR MAP defines the color for one or 
more dialog area color indices. The graphics area has its 
own set of color indices that are defined with the SET SUR- 
FACE COLOR MAP. 

The color assigned to Index applies only to alphatext 
characters. For the dialog area background and character 
backgrounds, Index always means "transparent." The 
concept of transparency is explained in The Graphics 
Terminal section. 



For example, the following command specifies white 
(HLS coordinates 0, 100, 0) for Index 3 in the dialog area: 

E cTF430F40 

In Setup syntax, this command is: 
DACMAP 4 3 100 

The 4 indicates that four values follow. 

See The Graphics Terminal 'section and the Tektronix Color 
Standard (in the appendices) for more details of how the 
terminal displays colors. 

Table 5-12 shows the factory default colors assigned to color 
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Table 5-1 2 
FACTORY DEFAULT COLOR INDICES 





Color 
Mixture 


Color Coordinates' 


Index 


H 


L 


S 


R 


G 


B 


c 


M 


Y 





BLACK 




















100 


100 


100 


1 


WHITE 


100 


100 


100 


100 


100 


100 











2 


RED 


120 


50 


100 


100 











100 


100 


3 


GREEN 


240 


50 


100 





100 





100 





100 


4 


BLUE 





50 


100 








100 


100 


100 





5 


CYAN 


300 


50 


100 





100 


100 


100 








6 


MAGENTA 


60 


50 


100 


100 





100 





100 





7 


YELLOW 


180 


50 


100 


100 


100 











100 



H = hue, L = lightness, S = saturation 

R = red, G = green, B = blue 

C = cyan, M = magenta, Y = yellow 
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SET DIALOG AREA INDEX 

Specifies the color index for aiphatext characters, charac- 
ter-cell background, and dialog area background. 

Host Syntax 



E cLI character-index 

character-background-index 
dialog-background-index 



Setup Syntax 



DAINDEX character-index 

character-background-index 
dialog-background-index 



character-index: integer; indicates the color index of the 
characters displayed in the dialog area; must be in the 
range through 65535. 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = 

character-background-index, integer; indicates the color 
index used for each character cell background; must be in 
the range through 65535. Index indicates transparency. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

dialog-background-index: integer; indicates the color index 
of the dialog area background. Must be in the range 
through 65535. This is the color of the dialog area before 
characters are written on it and after it is erased. Index 
indicates transparency. 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

Color Indices through 7 represent colors identified by the 
dialog area's color indices. These colors are defined by SET 
DIALOG AREA COLOR MAP. The dialog area has its own 
indices separate from those used for graphics. When you 
specify a value greater than 7 for any color index, the termi- 
nal uses Index 7. 



When the terminal displays a character in the dialog area, it 
also displays the character cell that encloses the character. 
The cell is displayed in the character background color. The 
color of a character cell is set by character-background- 
index. 

When Color Index is used as the character-index, it repre- 
sents an opaque color just like Color Indices 1 through 7. 
However, when Color Index is used as the character-back- 
ground-index or the dialog-background-index, it means 
"make this area transparent." Graphics behind the dialog 
area show through a transparent area; if the character back- 
ground is transparent, the dialog appears as h it is written 
on a piece of glass in fronts. 

SET DIALOG AREA LINES 

Specifies the maximum number of lines visible in the dialog 
area. 

Host Syntax 



E cLL number-of-lines 



Setup Syntax 



DALINES number-of-lines 



number-of-lines: integer; sets the maximum size in lines for 
the dialog area; must be in the range 2 through 32. 
Defaults Factory = 32 

Power-Up = Saved in memory 

Omitted = Error 

If you set the number of dialog area lines to be greater than 
the size of the dialog buffer, the size of the dialog buffer is 
changed to be the same size as the dialog area. 

If Column mode is set to 1 32, the maximum number of rows 
is 30, instead of 32. 
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SET DIALOG AREA VISIBILITY 

Specifies whether the dialog area is visible. 
Host Syntax 



E cLV visibility-mode 



Setup Syntax 



DAVISIBILITY visibility-mode 



visibility-mode: integer (keyword in Setup syntax) one of the 
following sets the dialog area to become either invisible or 
visible in Host or Setup modes. 
Host Setup 

no Dialog area invisible 

1 yes Dialog area visible 
Defaults: Factory = 1 (yes) 

Power-Up = Saved in memory 
Omitted = 1 (yes) 

This command serves the same purpose as the Dialog key 
— it sets whether the dialog area is visible. 

SET DIALOG VISIBILITY determines whether the dialog 
area is visible. ENABLE DIALOG AREA determines whether 
alphatext is sent to the dialog buffer. If the dialog area is 
enabled but not visible, alphatext is saved in the dialog 
buffer even though it is not visible. When SET DIALOG 
VISIBILITY is given (specifying 1 or yes), the alphatext in 
the dialog area becomes visible. The terminal will automati- 
cally scroll the dialog area, if necessary, to put the cursor in 
view. 



SET DIALOG AREA WRITING MODE 

Specifies whether the s p and (Underscore) characters 

overstrike or replace other characters in the dialog area. 

Host Syntax 



E cLM writing-mode 



Setup Syntax 



DAMODE writing-mode 



writing-mode: integer (keyword in Setup syntax); or 
replace indicates characters are replaced; 1 or overstrike 
indicates characters are overwritten. 
Defaults: Factory = (replace) 

Power-Up = Saved in memory 

Omitted = (replace) 

This command affects only how the Space and Underscore 
characters are displayed in the dialog area. If the dialog 
area is in Overstrike mode, you can underline alphanumeric 
characters. 

Alphatext displayed in the graphics area is not affected by 
this command. (Alphatext is displayed in the graphics area 
when the dialog area is disabled.) SET GRAPHICS AREA 
WRITING MODE sets overstrike capability for graphics area 

alphatext. 
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SET DIALOG HARDCOPY ATTRIBUTES 

Specifies the number of pages to be copied, the starting 
page, and how formfeed is interpreted. 

Host Syntax 



E cQL number-of-pages 
page-origin 
^-interpretation 



Setup Syntax 



HCDAATTRIBUTES number-of-pages 
page-origin 
^-interpretation 



number-of-pages: integer; determines the number of pages 
to be copied from the origin to the bottom of the dialog 
buffer. Must be in the range of to 32767. 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 1 

page-origin: integer; determines the starting page for the 
copy. Must be one of the following: 

Specifies the first visible line in the scroll 

1 Specifies the top of the scroll 

2 Specifies the bottom of the scroll 
Defaults: Factory = 

Power-Up = 
Omitted = 

F F-interpretation: integer; determines how the terminal inter- 
prets ASCII formfeed in the dialog buffer. Must be one of the 
following: 

Ignores f f and divides buffer into 66 line pages (60 
text lines plus 3 blank lines top and bottom) 

1 Starts new page every 66 lines or when f f appears 
in the text 

2 Starts new page only when f f appears in the text 
Defaults: Factory = 

Power-Up = 
Omitted = 



If the origin is set to the bottom of the dialog buffer, the copy 
begins that many pages up from the bottom of the dialog 
buffer. If number-of-pages is 0, then there is no change from 
the last setting. If you specify a greater number of pages 
than the dialog buffer contains, only the contents of the 
dialog buffer are copied. 

For pages that have lines longer than 80 characters, the 
terminal sends the extra characters without an intervening 
c r. This ailows printers with widths greater than 80 columns 
to be used. The TEKTRONIX 4695 Color Copier automati- 
cally generates a c r l f and starts printing on the next line for 
lines containing more than 80 characters. The 4695 prints 
the 1 32 characters on the same line if the SET COPY SIZE 
command has been executed with a parameter of 1 (to set 
the small copy size). 

When using this command, you need to be aware of how 
number-of-pages and ^-interpretation interact with each 
other. The amount of text ihat goes on each page can vary 
depending on how the terminal divides the dialog buffer into 
pages, and that depends on the setting of F F-interpretation. 
If you issue this command with its default parameters, it 
copies 60 lines of text, beginning with the first visible line on 
the screen. If, however, you set number-of-pages to 4, 
F F-interpretation to 2, and have four f f's beginning the text 
on the screen, then the copier turns out four blank sheets of 
paper. Additionally, if number-of-pages is 1 , page-origin is 1 , 
F F-interpretation is 2, and there are no f f's in the text, then 
the copier prints the entire dialog buffer with no page breaks. 
(On the TEKTRONIX 4695 Copier, this would be a con- 
tinuous sheet of paper). 

You can stop a hardcopy operation by pressing the 
CANCEL key. 
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SET ECHO 

Specifies whether the terminal echoes characters it trans- 
mits to the host. 

Host Syntax 



E cKE echo-mode 



Setup Syntax 



ECHO echo-mode 



echo-mode: integer (keyword in Setup syntax); must be one 
of the following: 
Host Setup 

no Sets remote echo; the terminal does not 

provide an echo 

1 yes Sets local echo; the terminal provides 

the echo 
Defaults: Factory = (no) 

Power-Up = Saved in memory 
Omitted = 1 (yes) 

When a character is typed on the keyboard, the character 
displayed on the screen is an echoed character. Some 
computers provide an echo, and some do not. If the host 
does not provide the echo, set the terminal for local echo; 
otherwise, characters typed on the keyboard will not appear 
on the screen. If the host does provide the echo, set the 
terminal to remote echo; otherwise, characters typed on the 
keyboard will be displayed twice, LLIIKKEE TTHHIISS. 

In Setup mode the terminal always provides the echo. 



SET EDIT CHARACTERS 

Host Syntax 



E cKZ character-delete 
line-delete 
take-literally 



Setup Syntax 



EDITCHARS character-delete 
line-delete 
take-literally 



character-delete: small integer; specifies which key will 
delete individual characters in Setup mode. 
Defaults: Factory = 127( d t) 

Power-Up = Saved in memory 

Omitted = Unchanged 

line-delete: small integer; specifies which key will delete a 
line in Setup mode. 
Defaults: Factory = 24 ( c n) 

Power-Up = Saved in memory 

Omitted = Unchanged 

take-literally: small integer; specifies character used in 
arrays to mean that "the following characters are to be 
taken literally, rather tha considered part of the array." 
Defaults: Factory = 126 (~) 

Power-Up = Saved in memory 

Omitted = Unchanged 
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SET EDIT CHARACTERS 

Specifies the terminal's special editing characters used in 
Setup mode. 



Host Syntax 



E cKZ character-delete, 
line-delete, 
literal 



Setup Syntax 



EDITCHARS character-delete, 
line-delete, 
literal 



character-delete: integer (small integer in Setup syntax); 
specifies the key used in Setup mode to erase the character 
just left of the cursor. 
Defaults: Factory =127( d t) 

Power-Up = Saved in memory 

Omitted = Unchanged 

line-delete: integer (small integer in Setup syntax); specifies 
the key used in Setup mode to erase the current line. 
Defaults: Factory = 24 ( c n ) 

Power-Up = Saved in memory 

Omitted = Unchanged 



tliefui. lllic^^i \o 



]a!i integer in Setup syntax); specifies the 
character used just before an editing character to suspend 
its control action and print it as text. Only the character 
immediately following the literal character is affected. Use 
the literal character before c r and the three special editing 
characters defined in this command. 
Defaults: Factory = 126 (~) 

Power-Up = Saved in memory 

Omitted = Unchanged 



In Setup syntax, precede ADEs less than ten with a 0. For 
example, 08 indicateds ADE 8, the Back Space character. 
The single digit 8 indicates the character 8, whose ADE is 
56. Refer to the ASCII Code Chart appendix. 
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SET EOF STRING 

Specifies the terminal's end-of-file string. 
Host Syntax 



E cNE EOF-string 



Setup Syntax 



EOFSTRING EOh-string 



EOF-string: integer array of small integers (delimited string 
in Setup syntax). Each integer in the array must be in the 
range from through 1 27. The array must define no more 
than 10 ASCII characters. 
Defaults: Factory = Empty array 

Power-Up = Saved in memory 

Omitted = Empty array 

This command defines the terminal's end-of-file string. 
When the terminal reaches the end of a file transmission to 
the host communications port, it appends the end-of-file 
string. When the terminal receives this string from the host 
port during a COPY operation, it knows that the end of a file 
transfer has been reached and terminates the COPY 
operation. 

The end-of-file string should be set to match whatever string 
your host actually sends at the end of a file. 

In Setup syntax you can enter either ASCII characters or 
ADEs for ASCI I characters. Enter ADEs less than 1 with a 
leading zero. For example, to enter the Back Space charac- 
ter with ADE 8, enter 08; just the character 8 will be inter- 
preted as the numeral 8 with ADE 56. 



SET EOL STRING 

Specifies the terminal's end-of-line string. 
Host Syntax 



E cNT EOL-string 



Setup Syntax 






EOL-string: integer array of small integers (delimited string 
in Setup syntax); each integer must be in the range from 
through 1 27. This parameter defines a string of no more 
than two ASCII Ct laracters. 
Defaults: Factory = 1 3 ( c r) 

Power-Up = Saved in memory 

Omitted = Empty array 

The terminal terminates each line of a report sent to the 
host with the end-of-line string. Typically this string consists 
of the single character c r (ADE 1 3). See the individual 
report descriptions for details. 

In Setup syntax you can enter either ASCII characters or 
ADEs of ASCII characters. Enter ADEs less than 1 with a 
leading zero. For example, to specify the Back Space char- 
acter, enter 08; entering 8 specifies the numeral 8 with 
ADE 56. 
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SET EOM CHARACTERS 

Specifies the character(s) used to terminate messages. 
Host Syntax 



E cNC first-EOM-indicator 

second-EOM-indicator 



Setup Syntax 



EOMCHARS first-EOM-indicator 

second-EOM-indicator 



first-EOM-indicator. small integer (in the range from 
through 1 27); indicates ADE of first end-of-message charac- 
ter. In Setup mode, you can enter the character or its ADE. 
Defaults: Factory = 13( c r) 

Power-Up = Saved in memory 

Omitted = ( n l) 

second-EOM-indicator. small integer (in the range from 
through 127); indicates ADE of second end-of-message 
character. In Setup mode, you can enter the character or 
its ADE. 
Defaults: Factory = 10 ( l f) 

Power-Up = Saved in memory 

Omitted = ( n l) 

This command sets the end-of-message or turnaround 
characters) for text transmission from the terminal to the 
host. This character or pair of characters is used for control- 
ling the flow of communications between the terminal and 
the host. 

For example, in Prompt mode, when the terminal transmits 
the end-of-message character(s), it stops transmitting until it 
receives a prompt string from the host and the transmit 
delay has expired (see SET TRANSMIT DELAY command). 
Then it sends the first character of the next line of text. 

If the terminal is not in Prompt mode, after sending the end- 
of-message character(s), it waits until the transmit delay has 
expired before sending further information. 



SET ERROR THRESHOLD 

Specifies the kinds of error messages the terminal displays. 
Host Syntax 



E cKT error-threshold-levei 



Setup Syntax 



ERRORLEVEL error-threshold-level 



error-threshold-level: integer; indicates a minimum error 
level displayed. Must be in the range through 4: 

Displays all messages, warnings, errors, and ter- 
minal failure messages 

1 Displays warnings, errors, and terminal failure 
messages 

2 Displays errors and terminal failure messages 

3 Displays terminal failure messages 

4 No messages, warnings, errors, or terminal failure 
messages displayed 

Defaults: Factory = 2 
Power-Up = 2 
Omitted = 

This command determines only the level of error messages 
that are displayed on the screen. Regardless of what level 
you set, the terminal records the eight most recent error 
messages and transmits them in response to a REPORT 
ERRORS command. 
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SET FIXUP LEVEL 

Specifies how often to update the screen display when 
changes are made to the current view. 

Host Syntax 



The following chart lists the fixup levels and their meanings: 



Fixup 
Level 



E cRF fixup-level 



Setup Syntax 



FIXUP fixup-level 



fixup-level: integer; specifies how frequently the terminal 
updates the current view in its display. Must be in the range 
through 6. 
Defaults: Factory = 6 

Power-Up = 6 

Omitted = 

A positive fixup level not listed in the chart has the same 
effect as the next lower fixup level that is listed. For 
instance, Fixup Level 3 has the same effect as Fixup Level 
2; Fixup Level 100 has the same effect as Fixup Level 6. A 
negative fixup level sets the fixup level to 0, and an error is 
generated. 



Meaning 

A RENEW VIEW command, a PAGE command, 
or pressing the G Erase or S Erase key com- 
pletely updates the view. (At Fixup Level 0, 
these are the only times the viewport contents 
are altered.) 

Performs the action for Fixup Level 0. Besides 
this, updates the display as additions are made 

■in iU/-. rti ii-i-/\nt \/ioui (VZr\r ir»o+ar>r*ci viuhon a lino ic 
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drawn in the current view, the display is 
updated to show that line. And, when a segment 
is made visible, the display is updated to show 
that segment.) 

(At Fixup Level 2, when a segment is moved, it 
is drawn in the new position, but not erased 
from its old position. The display is not updated 
when a segment is made invisible or deleted.) 

Performs the actions for Fixup Levels and 2, 
and erases segments displayed in XOR mode 
(by drawing them again in XOR mode) in 
response to commands that change the seg- 
ment's visiblity or position in terminal space. 

Segments displayed in Set mode are treated as 
in Fixup Level 2 (see SET SEGMENT WRITING 
MODE for a discussion of Set and XOR modes). 

Performs the actions for Fixup Levels through 
4, and erases a segment whenever it is made 

i«-iv»ic!l-»l£s r\r io *"4©l©+a/H •frrvm tho wiau/rtrtrt /Fr»r 
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segments drawn in Set mode, this is done by 
redrawing the segment in the current wipe 
index. For segments drawn in XOR mode, this 
is done by redrawing the segment in XOR 
mode.) 
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SET FLAGGING MODE 

Specifies the kind of flagging the terminal uses. 
Host Syntax 



E cNF flagging-mode 



Setup Syntax 



FLAGGING flagging-mode 



flagging-mode: integer (keyword in Setup syntax); must be 
one of the following: 
Host Setup 

none Specifies no flagging 

1 input Specifies D i/ D 3 flagging on input from 

the host 

2 output Specifies D i/ D 3 flagging on output to 

the host 

3 in/out Specifies D i/ D 3 flagging on both input 

from and output to the host 

4 DTR/CTS Specifies DTR (Data Terminal Ready) 

and CTS (Clear To Send) signal lines at 
the RS-232 connector to regulate data 
flow 
Defaults: Factory = (none) 

Power-Up = Saved in memory 

Omitted = (none) 

Flagging allows the terminal and host to signal each other 
when each is ready to send or receive data. This prevents 
the input queues of each from overflowing, thus losing data. 
This setting must match the flagging scheme used by your 
host. 

if the host uses the D i/ D 3 scheme, the operator can use the 
Ctrl-S and Ctrl-Q keys to stop and start output from the host. 
See the Communications section for more details. 



SET GIN AREA 

Allows a specified GIN area on an external GIN device to 
map onto the terminal's coordinate space. 

Host Syntax 



E cIV device-function-code 
window-specifier 
GIN-lower-left-corner 
G I N-upper-right-corner 



Setup Syntax 



GINAREA device-function-code 
window-specifier 
GIN-lower-left-corner 
G I N-upper-right-corner 



device-function-code: integer; specifies which device func- 
tions are to be affected by this area. See Table 5-6 (under 
ENABLE GIN) for valid device-function codes. 
Defaults: Factory = All 

Power-Up = all 

Omitted = 

window-specifier: integer; specifies the terminal space 
window into which the GIN area maps. The valid range of 
values are: 

-1 Window specified by SET GIN WINDOW 

command 
Window of current view 
Defaults: Factory = -1 
Power-Up = -1 
Omitted = 

GIN-lower-left-corner: xy-coordinate; specifies the lower- 
left corner of a rectangular region in the GIN device space. 
The valid range for both x- and y-coordinates include to 
4095. 
Defaults: Factory = 0,0 

Power-Up = 0,0 

Omitted = 0,0 
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GIN-upper-right-corner: xy-coordinate; specifies the upper- 
right corner of a rectangular region in the GIN device space. 
The vaiid range of both x- and y-coordinates include to 
4095. 
Defaults: Factory = 4095,4095 

Power-Up = 4095,4095 

Omitted = 4095,4095 

This command maps a specified rectangular region on a 
GIN device (a GIN area) onto a specified rectangular win- 
dow in terminal coordinate space. 

Device-Function. When you assign a GIN area to a device- 
function, the GIN area is assigned to all functions of the 
specified device. For example, if you assign a GIN area to 
the tablet-Locator device-function, and then invoke the 
tablet-Pick device-function, the same GIN area is used. 

Window Specifier. If you specify a window-specifier at -1 , 
the GIN device area (specified by the third and fourth 
parameters) is mapped into the terminal space region speci- 
fied by the most recent SET GIN WINDOW command. The 
specified GIN device area remains mapped into the speci- 
fied terminal space window until another SET GIN AREA 
command remaps it by enclosing the former device area 
within its own. 

If you specify a window-specifier of 0, the GIN device area is 
mapped into the window of the current view each time the 
device is enabled and a point within the GIN area is 
selected. This window changes when you change views. 
The window also changes when an operator does a Zoom or 
Pan operation. 



Coordinates. This command assumes that the GIN device 
is 4096-by-4096 units square. If the device is rectangular, 
the command assigns 4098 units to the long axis of the 
device, and an proportionate number of units to the short 
axis. 

The x- and y- coordinates you assign are sorted so that any 
two corners specify the rectangle. 

If you specify the two x-coordinates the same or the two y- 
coordinates the same (if the GIN area is zero in either direc- 
tion) then an error is generated, except when you specify 

i ii_ j.^ i /r\ r\\ :— *..u:.n.u *-.. <-. a a tkn ^IM o»-j"\a 

DUU1 CUrnerS LU Ub (U'U)' »■ VVlllui i/iwc, mo vjiii Qica 

defaults to from (0,0) to (4095,4095). 

You can define multiple GIN areas for the tablet but only one 
for joydisk or delta mode tablet. If the device specified in the 
device-function parameter is the terminal joydisk or delta 
mode tablet, the GIN area must be from (0,0) to 
(4095,4095). If you define overlapping areas on non-joydisk 
devices, and the device position is inside more than one 
GIN area, the most recently defined GIN area and window- 
specifier values are used. 

GIN coordinate data for the device is mapped from the GIN 
area on the associated window. If the window is that of the 
current view {window-specifier = 0), the movement rate 
remains in proper scale to the window, regardless of the 
zoom scale factor. 

To delete a GIN area, define a GIN area which totally covers 
the GIN area you want to delete. To delete all GIN areas, 
define both the GIN window and the GIN area to be from 
(0,0) to (4095,4095). 
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SET GIN CURSOR 

Selects a segment for use as the cursor for a particular 
device function code. 

Host Syntax 



E cIC device-function-code 
segment-number 



Setup Syntax 



GINCURSOR device-function-code 
segment-number 



L 



device-function-code: integer; enables the specified GIN 
device and its function. For valid values, see Table 5-6 
under ENABLE GIN. 
Defaults: Omitted = Error IC20 

segment-number: integer; selects a specific segment in the 
range to 32767 as a graphics cursor. Segment value is 
the crosshair cursor. 
Defaults: Factory = 

Power-Up = 

Omitted = Error IC20 

SET GIN CURSOR specifies which segment is to be used 
as the graphics cursor for all subsequent operations, using 
the specified graphics input device-function combination. 
No action is seen when this command is given; the result 
will be seen later, when an ENABLE GIN command is 
issued for the specified device-function combination. 

When a segment is enabled as the GIN cursor, it is the seg- 
ment's pivot point which replaces the intersection of the 
crosshairs in the default crosshair cursor. 

For selecting the GIN cursor, the ENABLE 4010 GIN com- 
mand is the same as an ENABLE GIN command for device- 
function-code (thumbwheels device, Locator function). 
That is, a SET GIN CURSOR command for device-function- 
code selects a cursor not only for use with ENABLE GIN 
commands with device-function-code 0, but also for use with 
ENABLE 401 GIN commands. 



When the named device-function is later enabled, the seg- 
ment attributes of this segment are changed as follows: 

• Detectabi I ity is tu rned off . 

• Visibility is turned on. (If the sampled device is the tablet, 
the segment is visible when the pen is in presence; when 
out of presence its visibility depends on the segment's 
original visibility attribute.) 

As the sampled device is manipulated, the cursor seg- 
ment's position is continuously updated. When a GIN event 
occurs, the cursor position is sent to the host as part of the 
GIN report for that event. 

When the device is disabled, the display mode, detectabil- 
ity, Shu ViSiuSiity attnuutss are restorGu to tiiGir original val- 
ues. The segment's postion attribute, however, is not 
restored. 

Defaults. If no SET GIN CURSOR command has been 
issued, Segment — the standard crosshair cursor — 
serves as the graphics cursor. By use of the SET GIN CUR- 
SOR command, however, another segment may be used as 
a graphics cursor. 

If Setup mode is entered while GIN is enabled, the graphics 
cursor will disappear until Setup mode is exited. While in 
Setup mode, the enabled device (joydisk or tablet) will not 
be used for input to the suspended GIN operation. 

Several device-functions can specify the same cursor 
although the cursor movement may be undefined if an 
attempt is made to use more than one such device-function 
at a time. 

If the specified segment does not exist, or if this command 
is issued while the specified function is enabled, an error 
occurs. 

The cursor is scaled according to the current window view- 
port transform and segment image transform. The pivot 
point of the cursor cannot be moved outside of the current 
viewport. If another view is selected as the current view, the 
cursor moves to that view's viewport and is scaled to reflect 
the new view's window viewport transform. However, the 
default crosshair cursor, unlike other segments, is not 
clipped at the viewport boundary. 
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If the cursor is the default cursor (Segment 0, the crosshair 
cursor), its position may be set with the SET SEGMENT 
POSITION command. However, the default cursor cannot 
be positioned outside the window for the current view. The 
terminal will position it as close to the specified point as 
possible, constraining it to be within the current window. 
Any graphic input device motion will restore the default 
cursor to its position prior to the SET SEGMENT POSITION 
command. 

If a cursor other than the default cursor is used, its position 
may be set using either the SET SEGMENT POSiTiON 
command or the SET SEGMENT IMAGE TRANSFORM 
command. If the nondefault cursor is set outside the current 
window, it ceases to be visible in the current viewport. How- 
ever, any graphics input device motion will restore the cur- 
sor back to its position prior to the SET SEGMENT 
POSiTiON or SET SEGMENT IMAGE TRANSFORM com- 
mand. It will then move from that point in response to the 
graphics input device. This device may not, by itself, move 
the cursor outside the window. 



SET GIN CURSOR COLOR 

Specifies the color mixture for the graphics crosshair cursor. 
Host Syntax 



E cTC first-color-coordinate 
second-color-coordinate 
third-color-coordinate 



Setup Syntax 



GCURSOR first-color-coordinate 

second-color-coordinate 
third-color-coordinate 



first-color-coordinate: integer; selects a color vaiue for the 
GiN crosshair cursor, arguments are interpreted according 
to current color mode. (See SET COLOR MODE command 
and Table 5-1 3.) 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 

second-color-coordinate: integer; selects a color value for 
the GiN crosshair cursor, arguments are interpreted accord- 
ing to current color mode. (See SET COLOR MODE com- 
mand and Tabie 5-i 3.) 
Defaults: Factory = 100 

Power-Up = Saved in memory 

Omitted = 

third-color-coordinate: integer; selects a color value for the 
GiN crosshair cursor, arguments are interpreted according 
to current color mode. (See SET COLOR MODE command 
and Tabie 5-1 3.) 
Defaults: Factory = 

Power-Up = Saved in memory 

Omitted = 



Table 5-1 3 
SET GIN CURSOR COLOR PARAMETER VALUES 



Parameter 


HLS 


RGB 


CMY 


first-color-coordinate 


— 360° 
(Hue) 


— 100 
(Red) 


— 100 
(Cyan) 


second-color-coordinate 


0—100 
(Lightness) 


— 100 
(Green) 


— 100 
(Magenta) 


third-color-coordinate 


0—100 
(Saturation) 


— 100 
(Blue) 


— 100 
(Yellow) 



This command specifies the color mixture for the graphics 
cursor according to the current color coordinate model 
(HLS, RGB, CMY). This color is independent of the eight 
dialog indices and the eight graphics indices and may be 
any of the 64 colors. 
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SET GIN DISPLAY START POINT 



SET GIN GRIDDING 



Specifies an initial point for GIN inking or GIN 
rubberbanding. 

Host Syntax 



E cIX device-function-code 
start-point 



Setup Syntax 



GINSTARTPOINT device-function-code 
start-point 



device-function-code: integer; enables the specified GIN 
device and its function. For valid values, see Table 5-6 
(under ENABLE GIN). 
Defaults: Omitted = 

start-point: xy-coordinate; specifies the initial point in termi- 
nal space coordinates to start an ink line or a rubberband 
line. The valid range of both xy-coordinates include to 
4095. 
Defaults: Omitted = 0,0 

This command sets the start-point that is used by the SET 
GIN RUBBERBANDING and SET GIN INKING commands 
when they are enabled with a parameter of 2. 



Restricts the set of possible GIN positions for Locate or Pick 
functions. 

Host Syntax 



E cIG device-function-code 
x-grid-spacing 
y-grid-spacing 



Setup Syntax 



GINGRIDDING device-function-code 
x-grid-spacing 
y-grid-spacing 



device-function-code: integer; enables the specified GIN 
device and its function. For valid values, see Table 5-6 
(under ENABLE GIN). 
Defaults: Omitted = 

x-grid-spacing: integer; sets the spacing between invisible 

horizontal grid space. The valid range of values include to 

4095. 

Defaults: Factory = 

Power-Up = 

Omitted = 

y-grid-spacing: integer; sets the spacing between invisible 

vertical grid space. The valid range of values include to 

4095. 

Defaults: Factory = 

Power-Up = 

Omitted = 

This command causes gridding for all subsequent opera- 
tions of the specified Locator or Pick functions. The x,y 
parameters specify an invisible grid that covers the entire 
terminal space. All further graphics cursor movement is 
constrained so that the cursor will always lie on points cor- 
responding to the intersections of these grid lines. 
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An x-spacing (or y-spacing) of zero disables gridding in the 
x-direction (y-direction). Specifying zero for both these 
parameters turns off the gridding feature. 

A grid spacing of one serves no useful purpose, since points 
cannot be closer together than one terminal space unit. (It 
would be better to specify a spacing of zero, and thus save 
some time by disabling gridding.) Note also that large grid 
spacings are impractical. X- and y-spacings of 4095 would 
permit only four accessible points, at the four corners of 
terminal space. 

Gridding applies only to the Locator and Pick functions; 
gridding is not permitted for the Stroke function. 

Default is no gridding (x- and y-spacing both zero). 

For purposes of gridding, an ENABLE 4010 GIN command 
is considered to be an ENABLE GIN command for device- 
function code 0. That is, a SET GIN GRIDDING command 
for device-function (joydisk device, Locator function) 
affects graphics input in response to an ENABLE 4010 GIN 
command as well as graphics input in response to an 
ENABLE GIN command for device-function zero. 



SET GIN INKING 

Turns inking on or off for all subsequent operations of the 
specified Locator or Stroke functions. 

Host Syntax 



•-en aevice-Tuncnon-coae 
inking-mode 



Setup Syntax 



GININKING device-function-code 
inking-mode 



inking-mode: integer; valid values are: 

Disables the inking feature 

1 Draws a line between the point selected by the 
preceding Locator event and the subsequent Loca- 
tor event 

2 Draws a line between the GIN display start-point 
and the subsequent Locator event 

Subsequent lines are then constructed identical to inking- 
mode 1 . 

Defaults: Factory = 
Power-Up = 



This command turns inking on or off for all subsequent 
operation of the specified Locator or Stroke function (inking 
is not allowed for the Pick function). 

When inking is turned on, each Locator event after the first 
causes a line to be drawn to the point selected by the Loca- 
tor event. During Stroke functions, a line is drawn between 
each point in the Stroke. 

The line Is drawn in Set mode using the current line style 
and line index. 

If inking-mode is 2, the first GIN point is "inked" from the 
GIN display start-point, set by the SET GIN DISPLAY START 
POINT command. After the first point, it is identical to ink- 
ing-mode = 1 . 

If inking-mode is 1 , and rubberbanding-mode is set to 2 by 
the SET RUBBERBANDING MODE command, then GIN 
inking behaves as if inking-mode was set to 2. 

You can use inking in Locate or Stroke functions so the 
operator can see where the GIN device has moved. When 
the operator causes a GIN event, the terminal draws a line 
from the location of the last GIN location to the current loca- 
tion. You can start inking after the first point is entered if you 
enable Inking mode with a value of 1 , or start inking immedi- 
ately from the GIN Display Start Point if you enable Inking 
mode 2. 



device-function-code: integer; enables the specified GIN 
device and its function. For valid values, see Table 5-6 
(under ENABLE GIN). 
Defaults: Omitted = 
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SET GIN RUBBERBANDING 

Turns rubberbanding on or off for all subsequent operations 
of the specified Locator function. 

Host Syntax 



E cIR device-function-code 
ru bberbandi ng-mode 



Setup Syntax 



GINRUBBERBANDING device-function-code 






device-function-code: integer; enables the specified GIN 
device and its function. For valid values, see Table 5-6 
under ENABLE GIN. 
Defaults: Omitted = 

rubberbanding-mode: integer; valid values are: 

Disables the rubberbanding feature 

1 Causes rubberbanding to occur between the most 
recent GIN Locator event and the current cursor 
position 

2 Causes initial rubberbanding to occur between the 
GIN Display Start Point and the current cursor 
position Subsequent rubberbanding is constructed 
identical to mode 1 . 

Defaults: Factory = 
Power-Up = 
Omitted = 



With rubberbanding turned on and the specified device- 
function enabled, a line is drawn from the most recently 
selected point to the current cursor position. The line is 
drawn in XOR mode, using the current line style and line 
index. If dashed lines are used, the pattern of dashes 
begins at the fixed end of the line. 

If rubberbanding-mode is 2, the first GIN point is "rubber- 
banded" from the GIN-display-start-point, set by the SET 
GIN DISPLAY START POINT command. After the first point, 
it is identical to rubberbanding-mode = 1 . 

If inking-mode, as set by the SET-INKING-MODE command, 
is 1 , and rubberbanding-mode is 2, then GIN inking behaves 

If rubberbanding is turned on or off while the GIN device is 
enabled, only subsequent points are affected. 

The beam position is not affected by rubberbanding. 

You can use rubberbanding with the Locate function to draw 
an elastic line between the GIN start point or last GIN event 
and the location of the current cursor position. As with ink- 
ing, you can control rubberbanding with parameters to the 
command. The terminal draws the elastic line in XOR mode, 
using the current line style and line index. If dashed lines 
are used, the portion of dashed lines begins at the fixed end 
of the line. If ruberbanding is turned on or off while the GIN 
device is enabled, only subsequent points are affected. The 
electron beam position is not affected by the rubberbanding 
mode. 



This command turns rubberbanding on or off for all subse- 
quent operations of the specified Locator function. Rubber- 
banding is not allowed for the Pick and Stroke functions. 
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SET GIN STROKE FILTERING 

Restricts the number of GIN Stroke Reports sent to the 
host. 

Host Syntax 



E cIF device-f unction-code 
distance-filter 

time-filter 



Setup Syntax 



GINFILTERING device-function-code 
distance-filter 
time-filter 



Time Filter. The time-filter parameter specifies the mini- 
mum time in milliseconds that will elapse between succes- 
sive points. rtS the operator moves the tablet pen or 
four-button cursor, GIN stroke reports are sent to the host 
only at intervals of "time" milliseconds. 

The terminal measures time in increments of about 33 milli- 
seconds. Thus, specifying a time of 1 ms is, for practical 
purposes, the same as specifying a time of zero. Again, for 
pratical purposes, 27 ms is the same as 33 ms. 

If both the distance-filter and time-filter parameters are non- 

-rarr, thon all /~ritaria rtf hnth naramotarc mnct ho mot fnr an 
.-w.w, ...~.. „.. ~...~..„ „. .,„.. . f,ct. „.,.„.„.„ ...„„.„„..,„. .*.. — 

Stroke report to be sent to the host. 

When Stroke filtering is first enabled (or when the tablet 
stylus or cursor is lifted away from the tablet), the filters are 
reset so that at the first pen contact, a point is returned. 



device-function-code: integer; enables the specified GIN 
device and its function. Only valid for device-function codes 
1 and 1 8 (see Table 5-6 under ENABLE GIN). 
Defaults; Omitted = Error IF10 (No Stroke filtering on 
joydisk) 

distance-filter: integer; sets the distance the GIN device 
must be moved before issuing a GIN Stroke Report. dis- 
ables the distance filter. Valid values in the range 1 to 4095 
establish the minimum distance in terminal space for either 
x or y movement to reach the distance threshold. Once 
exceeded, the terminal waits until the time threshold (if 
enabled) is exceeded before sending a GIN Stroke Report 
to the host. 
Defaults: Factory = 

Dm>fSM> I In C\ 

Omitted = 

time-filter: integer; sets the minimum interval between GIN 
Stroke Reports. disables the time filter. Valid values in the 
range of 1 to 32767 establish the minimum interval in milli- 
seconds (resolution ~ 33ms) between Stroke events. Once 
exceeded, the terminal waits until the distance threshold is 
exceeded before sending a GIN Stroke Report to the host. 
Defaults: Factory = 

Power-Up = 

Omitted = 



Note that if either the distance or the time parameter is zero, 
then that type of filtering is absent. With no filtering, points 
are output at the maximum speed of the tablet interface. 

Filtering does not affect the cursor movement, but does 
affect the image formed by inking: inking occurs only 
between those points whose coordinates are reported to the 
host. 

Locator and Pick functions are not affected. Default is no 
filtering. 

When you are using the Stroke function with a graphics 
tablet, you may want to restrict the number of GIN Stroke 
events and reports that the terminal generates. You can 
s n ecif« f~\\ the minimum distance the tablet device moves 
before sending a report with a distance filter and (2) the 
minimum time between reports with a time filter. When both 
filters have values greater than 0, they act as thresholds 
and must be both exceeded before the terminal will send a 
GIN Stroke Report. When Stroke filtering is first enabled (or 
when the tablet stylus or cursor is lifted away from the tab- 
let), the filters are reset so that at the first pen contact, a GIN 
Stroke Report is sent to the host. 



The specified Stroke filtering parameters are applied to all 

subsequent operations of the specified Stroke function, 
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SET GIN WINDOW 

Sets the terminal space window to be used by the SET GIN 
AREA command with a parameter of -1 . 

Host Syntax 



E cIW lower-left-corner 
upper-right-corner 



Setup Syntax 



GINWINDOW lower-left-corner 
upper-right-corner 



lower-left-corner: xy-coordinate; specifies (in terminal 
space) one corner of the GIN window. Valid values for the 
x- and y-coordinates range from to 4095. 
Defaults: Factory = 0,0 

Power-Up = 0,0 

Omitted = 0,0 

upper-right-corner: xy-coordinate; specifies (in terminal 
space) the opposite corner of the GIN window. Valid values 
for the x- and y-coordinates range from to 4095. 
Defaults: Factory = 4095,4095 

Power-Up = 4095,4095 

Omitted = 4095,4095 

You can establish a rectangular area in terminal space as 
the GIN window. This window is used for the GIN area spec- 
ified with the window specifier of -1 . 

This command sets a window in terminal space which can 
be used by the SET GIN AREA command. If SET GIN AREA 
specifies a window-specifier of -1 , then the GIN area also 
specified by that command is mapped into the window in 
terminal space specified by the latest SET GIN WINDOW 
command. 

The x- and y- coordinates you assign are sorted so that any 
two corners specify the rectangle. 



SET GRAPHICS AREA WRITING MODE 

Specifies whether the terminal overwrites or replaces a 
character in the graphics area of the display. 

Host Syntax 



E cMG writing-mode 



Setup Syntax 



GAMODE writing-mode 



writing-mode: integer (keyword in Setup syntax); must be 
chosen from the following: 


Host 

1 
Defaults: 


Setup 

replace 

overstrike 

Factory 

Power-Up 

Omitted 


Specifies replace 
Specifies overstrike 
= 1 (overstrike) 
= Saved in memory 
= (replace) 



This command affects the way alphatext (not displayed in 
the dialog area) and String-precision graphtext are dis- 
played in the graphics area. 

If writing-mode is set to overstrike, a character will be dis- 
played on top of an existing character without erasing the 
existing character. You can use overstrike to underline char- 
acters with (the Underscore character). 

If writing-mode is set to replace, the terminal erases the 
existing character (with the current wipe index specified by 
SET VIEW ATTRIBUTES) and displays the new character in 
place of the existing one. 

Alphatext displayed in the dialog area is not affected by this 
command. (Alphatext is displayed in the dialog area when 
the dialog area is enabled.) SET DIALOG AREA WRITING 
MODE sets overstrike capability for dialog area alphatext. 
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SET GRAPHTEXT FONT 

Determines which character font will be used to display 
subsequent stroke-precision graphtext. 

Host Syntax 



E cMF font-number 



Setup Syntax 



GTFONT font-number 



Defaults: Factory 
and 
Power-Up 



font-number: integer; specifies the character font that will 
be used to display subsequent graphtext. Must be in the 
range through 32767. 

if ASCII keyboard 

1 if Swedish keyboard 

2 if German keyboard 

3 if United Kingdom keyboard 

9 if Danish/Norwegian keyboard 
12 if French keyboard 
Omitted = 

Fonts are numbered from through 32767; Fonts 0, 1 , 2, 3, 
9, and 1 2 are predefined as listed in Table 5-1 4. The termi- 
nal detects an error if you issue this command for an unde- 
fined font. 



SET GRAPHTEXT FONT GRID 

Creates a graphtext font and specifies the dimensions of the 
grid (character cell) used for defining characters in the font. 

Host Syntax 



E cSG font-number 
grid-width 
grid-height 



Setup Syntax 



GTGRID font-number 
grid-width 
grid-height 



font-number: integer; names the graphtext font for which a 
font grid is being defined. Must be in the range to 32767. 
Defaults: Omitted = 

grid-width: integer; specifies the width of each grid in termi- 
nal space units. Must be in the range 1 to 4095. 
Defaults: Omitted = Error 

grid-height: integer; specifies the height of each grid in 
terminal space units. Must be in the range 1 to 4095. 
Defaults: Omitted = Error 



Table 5-1 4 

PREDEFINED 
GRAPHTEXT FONTS 



Font 
Number 


Graphtext Font 





Standard ASCII 


1 


Swedish 


2 


German 


3 


United Kingdom 


9 


Danish/Norwegian 


12 


French 



You can consider the grid to be a character cell; the grid 
width and height are those of an uppercase character. 
When defining a character with the BEGIN GRAPHTEXT 
CHARACTER command, the coordinates the terminal 
receives should stay generally within the bounds of the grid. 
However, characters can extend outside their font grids (as 
shown in Figure 5-1 1). The font grid is only used in scaling 
characters to fit the current graphtext size. 

This command must be given before any characters are 
defined in the specified font. An error occurs, however, if 
any user-defined characters exist in the specified font. 
Once you delete all user-defined characters in that font (see 
DELETE GRAPHTEXT CHARACTER) you may issue a SET 
GRAPHTEXT FONT GRID command. 



Any undefined characters in a user-defined font default to 
the corresponding characters of the predefined font with the 
same font number. If there is no predefined font with that 
number, the corresponding characters of Font are used. 
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Figure 5-1 1 . Font Grids for Two User-Defined Characters. 
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SET GRAPHTEXT PRECISION 

Selects string-precision or stroke-precision to draw 
graphtext characters. 

Host Syntax 



E cMQ precision 



Setup Syntax 



GTPRECISION precision 



precision: integer (keyword in Setup syntax). Must be cho- 
sen from the following: 
Host Setup 

t string Specifies string-precision 

2 stroke Specifies stroke-precision 

Defaults: Factory = 2 
Power-Up = 2 
Omitted = Error 



When string-precision is selected, the terminal displays 
graphtext using dot matrix characters simiiar to alphatext. 
Unlike alphatext, however, string-precision graphtext can 
be scaled with the SET GRAPHTEXT SIZE command, 
rotated with the SET GRAPHTEXT ROTATION command, 
and have its character path set with the SET CHARACTER 
PATH command. See the descriptions of these commands 
for detailed information. 

When stroke-precision is selected, the terminal displays 
graphtext using Stroke characters. This permits more pre- 
cise settings of the character size and rotation angles. 
Stroke-precision graphtext also permits a broader range of 
character styles because you can define characters to suit 
individual needs using the BEGIN GRAPHTEXT CHARAC- 
TER command. 



4107/4109 PROGRAMMERS 



5-89 



4100-STYLE COMMANDS & REPORTS 
SET GRAPHTEXT ROTATION 



SET GRAPHTEXT ROTATION 

Specifies the rotation angle (in degrees) for all subsequent 
graphtext strings. 

Host Syntax 



e cMR angle 



Setup Syntax 



GTROTATION angle 



angle: real; specifies the rotation angle in degrees, from the 
direction of the positive x-axis. Must be in the range 
-32767.0 to 32767.0. 
Defaults: Factory =0.0 

Power-Up = 0.0 

Omitted = 0.0 

The rotation angle may be any real number in the range - 
32767.0 to 32767.0; the terminal converts this modulo 360 
to a number in the range 0.0 to 360.0 degrees. Positive 
angles represent counterclockwise rotations, while negative 



angles represent clockwise rotations. An angle of ° means 
that individual graphtext characters are displayed in their 
nomral, upright positions. Each subsequent character in a 
string is normally displayed to the right of the previous char- 
acter; however, this can be changed by the SET CHARAC- 
TER PATH command. 

For string-precision graphtext, the terminal arrays the text 
string along a line that is rotated to the specified rotation 
angle. However, the characters themselves only rotate to 
the nearest multiple of 90°. Thus, characters at angles 
between: 



0.0 and 45.0° 


= 





45.0 and 135.0° 


= 


90 


135.0 and 225.0° 


= 


180 


225.0 and 315.0° 


= 


270 


315.0 and 360.0° 


= 






Stroke-precision graphtext can be displayed at any rotation 
angle. The characters in the text string rotate in concert with 
the line of text. 

Figure 5-1 2 compares the stepped effect that occurs when 
rotating string-precision graphtext to the smooth rotation of 
stroke-precision graphtext. 



Effect on String Precision Graphtext 



Examples 
Rotation Angle 



ABC 



PI 



B l 






30° 



45° 



Effect on Stroke Precision Graphtext 



Examples 
Rotation Angle 



hBC 



0° 



X 

30° 



X 

45 



'■:-. "■■■■' 



90° 



m 

90° 



Note: Graphtext is "ABC" and character path is right in all examples, 
x is graphics position before graphtext is displayed. 



Figure 5-12. Graphtext Rotation Examples. 
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SET GRAPHTEXT SIZE 

Sets the size of graphics text. 
Host Syntax 



E cMC width 
height 
spacing 




width: integer; specifies width of a graphtext character cell, 

91 1 ici ii in idi spauc uliiia. iviUSi uc in li ic i ai lye u iMi uuyi i 

4095; specifies the default values. 
Defaults: Factory = 39 

Power-Up = 39 

Omitted = Error 

height: integer; specifies height of a graphtext character 
cell, in terminal space units. Must be in the range through 
4095; specifies the default values. 
Defaults: Factory = 59 

Power-Up = 59 

Omitted = Error 

spacing: integer; specifies the spacing, in terminal space 
units, between adjacent character cells in the same 
graphtext string. Must be in the range through 4095. 
Defaults: Factory = 12 

Power-Up = 12 

Omitted = 



When displaying stroke-precision graphtext, the width and 
height define the size of a character. The spcicifi deter- 
mines the size of the space between one character cell and 
the next. Where the space occurs depends on the character 
path set by the most recent SET CHARACTER PATH com- 
mand. For instance, if the character path is "right", the 
space occurs between the right edge of one character cell 
and the left edge of the next. However, if the character path 
is "down", the space occurs between the bottom edge of 
one character cell and the top edge of the next. 

Whpn Hisnlavinn strinn-nrerisinn nranhteyt the terminal 

...._.. ..w r j ...jj _ -, ,_. . - — ,-- , --- -- 

uses only the height parameter; the width and spacing 
parameters are accepted and stored, but ignored. The 
terminal displays string precision graphtext in several fixed 
sizes. The smallest available size displays an uppercase 
letter as seven pixels wide and nine pixels high; the other 
available sizes are integer multiples of the smallest size. 
Table 5-1 5 gives the height ranges that yield the first three 
character sizes available. The terminal examines the height 
you specify and displays the string-precision graphtext in 
the closest available size. 



Table 5-1 5 

STRING-PRECISION 
GRAPHTEXT SIZE EXAMPLES 3 



Specified Height 
(TSU) 


Resulting Size 
(Pixels) 


1— 88 


7x 9 


89 — 146 


14x18 


-i 47 OQ5 


18 x27 



These examples assume the default window size 
is used. 
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SET GRAPHTEXT SLANT 

Specifies the slant each stroke-precision graphtext charac- 
ter has from the vertical. 

Host Syntax 



E cMA slant-angle 



SET KEY EXECUTE CHARACTER 

Specfies the character that directs the flow of macro 
expansion. 

Host Syntax 



E cKY key-execute-char 



Setup Syntax 



GTSLANT slant-angle 



Setup Syntax 



KEYEXCHAR s p key-execute-char 



slant-angle: real; specifies the angle each Stroke-precision 

graphtext character is slanted, in degrees clockwise from 

the vertical. Must be in the range -32767.0 through 

32767.0. 

Defaults: Factory = 0.0 

Power-Up = 0.0 

Omitted = 0.0 



key-execute-char: integer; specifies the character that 
causes the terminal to direct the expansion of a macro to 
the host or the terminal. Valid values are in the range 
through 127. 
Defaults: Factory = 16 

Power-Up = Saved in memory 

Omitted: = 



If you specify a negative slant, the character is slanted 
counterclockwise. 



This command sets the value of the key-execute character, 
used with the DEFINE MACRO command. 



Normally, when the operator presses a key which has been 
programmed (with the DEFINE MACRO command), the 
characters programmed into the key are sent to the host 
computer, just as if the operator had typed those characters 
manually. This includes characters which make up an 
escape-sequence command for the terminal; the terminal, 
instead of executing such a command, sends the individual 
characters to the host. 

If the terminal is sending macros to the host, the key-exe- 
cute character means "use what follows locally." If the ter- 
minal is currently using macros locally, the key-execute 
character means "send what follows to the host." 

The key-execute character has this special effect only when 
the macro containing it is invoked by pressing a key. If, 
instead, the macro is invoked with an EXPAND MACRO 
command, then the key-execute character is treated like 
any other character in the macro definition. 
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Specifies the color index for all subsequent lines, panel 
boundaries, and markers. 

Host Syntax 



E cML line-index 



Setup Syntax 



LINEINDEX line-index 



line-index: integer; indicates the color index for lines, panel 
boundaries, and markers; must be in the range to 32767 
(values greater than 1 5 set line-indexto 1 5). 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

After this command is issued, all new lines, panel bounda- 
ries, and markers have the specified color index. This con- 
tinues until the terminal receives another SET LINE INDEX 
that changes the color index. 

If you specify a line index greater than the maximum index 
for the particular surface you are drawing on, the terminal 
uses the maximum index as the line index. The maximum 
color index for any particular surface is (2")-1 , where n is 
the number of bit planes assigned to that surface. 

A host program assigns a color to a color index with SET 
SURFACE COLOR MAP. An operator can use the color 
interface (see 4107/4109 Operators Manual) or the Setup 
command CMAP. 



4100-STYLE COMMANDS & REPORTS 
SET LINE STYLE 



SET LINE STYLE 

Specifies the line style for subsequent lines and panel 
boundaries. 



Host Syntax 



E cMV line-style 



Setup Syntax 



LINESTYLE line-style 



line-style: integer; indicates a predefined line style. Must be 
in the range through 7. 
Defaults: Factory = 

Power-Up = 

Omitted = 

Figure 5-1 3 illustrates the line styles. The terminal will dis- 
play all new lines, and panel boundaries with the line style 
specified in this command or with SET 401 4 LiNE STYLE, 
whichever was last executed. Existing items are not 
changed by this command. 



Parameter 


-i 

2 
3 

4 
5 

6 

7 



Line Style 



Figure 5-1 3. Line Styles 



4107/4109 PROGRAMMERS 



5-93 



4100-STYLE COMMANDS & REPORTS 
SET MARKER TYPE 



SET MARKER TYPE 

Specifies the kind of marker to be drawn. 
Host Syntax 



E cMM marker-number 



Setup Syntax 



MARKERTYPE marker-number 



marker-number: integer; indicates a predefined marker 
type. Must be in the range through i 0. 
Defaults: Factory = 

Power-Up = 

Omitted = 

When you change marker types, markers already displayed 
remain the same. 

Figure 5-1 4 illustrates the marker types. 





Marker 




Marker 


Parameter 


Type 


Parameter 


Type 
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B 


3 


% 


9 


* 
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10 


H 


5 


X 




4526-42 



SET PARITY 

Specifies the kind of parity the terminal uses when it trans- 
mits to the host. 

Host Syntax 



E cNP parity mode 



Setup Syntax 



PARITY parity mode 






none 


1 


odd 


2 


even 


3 


high 


4 


data 



parity-mode: integer (keyword in Setup syntax); must be 
one of the following: 
Host Setup 

Sets parity bit to 
Sets odd parity 
Sets even parity 
Sets parity bit to 1 

Sets no parity; parity bit is used for data 
Defaults: Factory = (none) 

Power-Up = Saved in memory 
Omitted = (none) 

This command defines how the parity bit is set on charac- 
ters output to the host RS-232 port. This setting must match 
the parity checking scheme that the host uses on incoming 
data. 

With odd parity the eighth bit in each character's binary 
ASCII representation is set so that the sum of all the bits in 
the character is odd. With the even parity the eighth bit is set 
so that the sum of all the bits in the character is even. 

The terminal ignores the parity bit in characters it receives 
from the host. 



Figure 5-14. Marker Types. 
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SET PICK APERTURE 

Sets the size of a square aperture in terminal space used to 
Pick graphics segments. 

Host Syntax 



E cIA aperture-width 



Setup Syntax 



GINAPERTURE aperture-width 



aperture-width: integer; specifies, in terminal space the 

width of the pick aperture. Valid values range from to 

4095. 

Defaults: Factory = 8 

Power-Up = 8 

Omitted = 



The aperture-width may be any integer in the range from 
to 4095. If the parameter is omitted (by terminating the 
command early), the terminal assumes a value of zero. Very 
large pick apertures, although allowed, are impractical. 

The specified size of the pick aperture is an approximate 
number. Because of the rounding that occurs when trans- 
forming coordinates from terminal space to raster memory 
space (and vice-versa), it is possible to Pick a line that is 
slightly outside the stated aperture. 

SET PICK APERTURE sets the size of the aperture, or 
acceptance area around the graphics cursor. The pick aper- 
ture is a square in normalized screen space centered on the 
GIN location. To Pick a segment, the pick aperture must 
cover at least a portion of the segment you want to Pick. If 
the width is 4, then part of the segment being Picked must 
have its x-coordinate in the range from xO - 2 to xO + 2, and 
its y-coordinate in the range from yO - 2 to yO + 2, where 
(x0,y0) is in the GIN cursor position. 



The pick aperture is a square in normalized screen space, 
centered on the current beam position. During a GIN Pick 
operation part of the segment Picked must fall within the 
pick aperture. (For details, see the ENABLE GIN command 
description, and the description of GIN Pick Reports under 
the REPORT GIN POINT command description.) 

The aperture-width parameter sets the width of the pick 
aperture square, in normalized screen coordinate units. If 
the width is zero, then part of the segment being Picked 
must fall exactly at the current cursor position. If the width is 
4, then part of the segment being Picked must have its x- 
coordinate in the range from xO-2 to xO + 2, and its y-coordi- 
nate in the range from yO-2 to yO + 2, where (x0,y0) is the 
current beam position in normalize screen space. 



4107/4109 PROGRAMMERS 



5-95 



4100-STYLE COMMANDS & REPORTS 
SET PICK ID 



SET PICK ID 

Marks the next xy location added to the currently open 
segment as a Pick point and assigns it an identification 
number. 

Host Syntax 



E cMI pick-ID-number 



Setup Syntax 



SGPICKID pick-ID-number 



pick-ID-number, integer; specifies the Pick-ID for parts of 

the currently open segment. Must be in the range through 

32767. 

Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

The Pick-ID numbers are integers in the range from to 
32767. Only those parts of a segment which are flagged 
with positive Pick-ID numbers can be Picked. Pick-ID num- 
ber marks a part of a segment that cannot be Picked. 

The Pick-ID numbers are graphics primitives, but unlike 
other graphics primitives, they have no direct effect on the 
appearance of a picture. Like other graphics primitives, 
Pick-ID numbers are permanent parts of the segment and 
cannot be changed once the segment has been defined. 
Therefore, the SET PICK ID command is only valid while a 
segment is being defined. If you issue a SET PICK ID com- 
mand while no segment is currently being defined, the 
terminal detects an error. 



At the start of a segment definition, the Pick-ID number is 
reset to 1 . While defining the segment, you can issue SET 
PICK ID commands to label subsequent parts of the seg- 
ment with different Pick-ID numbers. 



NOTE 

To make it easier to create "menus," the INCL UDE 
COP Y OF SEGMENT command does not copy 
the initial (assumed) Pick-ID. 

When a segment is Picked during a graphics input opera- 
tion, the Pick-ID for the part of the segment within the pick 
aperture is returned to the host computer. This lets the host 
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Picked, but also which part of the segment was Picked. 

If, during the Pick operation, the pick aperture is so large as 
to cover parts of the segment with different Pick-ID num- 
bers, then the terminal returns the last of the Pick-IDs in the 
display list for parts of the segment within the pick aperture. 
If, on the other hand, no visible, detectable segment falls 
within the pick aperture, the terminal sends a GIN Pick 
Report in which the Pick-ID number is zero. 

If several detectable and visible segments are in the Pick 
aperture, then the highest priority segment is Picked. 
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SET PIVOT POINT 



SET PIXEL BEAM POSITION 



Specifies the pivot point for subsequent segment 
definitions. 

Host Syntax 



E cSP pivot-point 



Setup Syntax 



SGPIVOT pivot-point 



pivot-point, xy-coordinate; specifies the pivot point for 
subsequent segment definitions. Values for x and y must be 
in range through 4095. 
Defaults: Factory = (0,0) 

Power-Up = (0,0) 

Omitted = (0,0) 

The pivot point is a point within the segment that defines the 
position of the segment when that segment is displayed. 
When a BEGIN SEGMENT command creates a new seg- 
ment, its pivot point and its position are both set to the xy- 
coordinate specified by the most recent SET PIVOT POINT 
command. Once a segment has been defined, its pivot point 
cannot be changed within the segment definition. However, 
the position of the whole segment can be relocated within 
the viewport by using a SET SEGMENT POSITION or a 
SET SEGMENT IMAGE TRANSFORM command; it is the 
segment's pivot point that appears at the new position. 

The pivot point is the point at which subsequent graphics 
objects and segments begin. For image transforms (see 
SET SEGMENT IMAGE TRANSFORM command), the pivot 
point is the point around which rotation occurs and about 
which all scaling occurs in both x- and y-directions. 

The actual x- and y-coordinate values of the pivot point 
when the segment is created are only saved in the segment 
for use by the SAVE and REPORT SEGMENT STATUS 
commands. 



Sets the position of the pixel beam in the pixel viewport for 
use by subsequent RASTER WRITE or RUNLENGTH 
WRITE commands. 

Host Syntax 



E cRH beam-position 



Setup Syntax 



PXPOSITION beam-position 



beam-position: xy-coordinate; specifies the position where 
the next RASTER WRITE or RUNLENGTH WRITE com- 
mand will take effect. Values for x range from through 639; 
for y, from through 51 1 . 
Defaults: Factory = (0,479) 

Power-Up = (0,479) 

Omitted = (0,0) 

The pixel beam position coordinates are relative to the 
lower-left corner of the pixel viewport. 

If the pixel beam is set to a position outside the pixel view- 
port, the terminal moves the beam to the nearest pixel 
inside the viewport. Thus, if the viewport has lower-left and 
upper-right corners located at (100,100) and (200,200), 
respectively, a beam position of (1 50, 1 50) places the beam 
at the upper-right corner of the viewport. 
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SET PIXEL VIEWPORT 

Sets the pixel viewport position on the pixel writing surface. 
Host Syntax 



E cRS lower-left 
upper-right 



Setup Syntax 



PXVIEWPORT lower-left 
upper-right 



lower-left: xy-coordinate; specifies (in raster memory 
space) one corner of the pixel viewport. Values for x range 
from to 639; for y, from to 51 1 . 
Defaults: Factory = (0,0) 

Power-Up = Saved in memory 

Omitted = (0,0) 

upper-right: xy-coordinate; specifies the opposite corner of 
the pixel viewport. Values for x range from to 639; for y, 
from to 511 . 
Defaults: Factory = (639,479) 

Power-Up = Saved in memory 

Omitted = (0,0) 

The SET PIXEL VIEWPORT command updates the current 
pixel beam position to the upper-left corner of the pixel 
viewport. The lower-left and upper-right coordinates may 
actually be the coordinates of any two diagonally opposite 
corners of the pixel viewport. The terminal will sort the x- 
and y-coordinate values to determine the correct upper and 
lower corners. 

You can set the viewport's y-direction to include the pixels 
480 to 51 1 , which are off the screen. A Level warning will 
be generated, however. 



SET PORT BAUD RATE 

Specifies the baud rate for a specified peripheral port. 
Host Syntax 



E cPR port-identifier 
baud-rate 



Setup Syntax 



PBAUD port-identifier 
baud-rate 



L 



port-identifier: string; must be one of the following: 
P0: Specifies Peripheral Port 
P1 : Specifies Peripheral Port 1 

baud-rate: integer; specifies the rate (in bits per second) at 
which data will be transmitted to the specified port. Valid 
rates are: 75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 
2400, 4800, and 9600. 
Defaults: Factory = 2400 

Power-Up = Saved in memory 

Omitted = error 

This command sets the baud rate for the specified RS-232 
peripheral port. 
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SET PORT EOF STRING 

Sets the end-of-file string for the specified peripheral port. 
Host Syntax 



E cPE port-identifier, 
EOF-string 



Setup Syntax 



PEOF port-identifier, 
EOF-string 



port-identifier: string; identifies the port to be assigned an 
end-of-fi!e string. Must be one of the following: 

PO: Specifies Peripheral Port 

PI : Specifies Peripheral Port 1 

EOF-string: integer array of up to 1 elements; contains the 

ADEs of each character in the port's end-of-file string. Each 

integer in the array must be in the range from through 1 27. 

In Setup syntax you can enter ADEs or the ASCII characters 

themselves. 

Defaults: Factory = Empty array 

Power-Up = Saved in memory 

Omitted = Empty array 

This command sets the end-of-file string used when a file is 
transmitted to the specified RS-232 peripheral port. During 
a COPY or PLOT to that device, when an end-of-file condi- 
tion /POP\ ie Hotor*tpH tho terminal conHc tho cnorMfioH ortri- 
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of-file string and terminates the PLOT or COPY operation. 
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SET PORT FLAGGING MODE 

Sets the flagging mode for the specified peripheral port. 
Host Syntax 



E cPF port-identifier 
flagging-mode 
go-character 
stop-character 



Setup Syntax 



PFLAG port-identifier 
flagging-mode 
go-character 
stop-character 



port-identifier: string; specifies the port to be assigned a 
flagging mode. Must be one of the following: 

PO: Specifies Peripheral Port 

P1 : Specifies Peripheral Port 1 

flagging-mode: integer (keyword in Setup syntax); must be 



one of the following: 




Host Setup 




none 


Specifies no flagging 


1 char 


Specifies character flagging 


2 DTR/CTS 


Specifies flagging using the DTR, 




CTS signal lines 


Defaults: Factory 


= 1 


Power- Ur> 


= Saved in memory 


Omitted 


= 



go-character: integer in the range from through 1 27 (or 
ASCII character in Setup syntax); specifies the character 
that indicates the terminal can receive data when character 
flagging is used. A value of sets D i as the go-character. 
Defaults: Omitted = (go-character is D i) 

stop-character: small integer in the range from through 
1 27 (or ASCII character in Setup syntax); specifies the char- 
acter that indicates the terminal is not ready to receive data 
when character flagging is used. A value of sets D 3 as the 
stop-character. 
Defaults: Omitted = (stop-character is D 3) 

This command sets the flagging mode for the specified 
peripheral port. See the SET FLAGGING MODE command 
for an explanation of the various flagging modes. 
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SET PORT PARITY 

Specifies the parity scheme for output to the specified 
peripheral port. 

Host Syntax 



E cPP port-identifier 
parity-mode 



Setup Syntax 





1 
2 
3 

4 



low 

odd 

even 

high 

none 



port-identifier: string; identifies the port to be assigned a 
parity scheme. Must be one of the following: 

P0: Specifies Peripheral Port 

P1 : Specifies Peripheral Port 1 

parity-mode: integer (keyword in Setup syntax); must be 
one of the following: 
Host Setup 

Sets parity bit to zero 
Sets odd parity 
Sets even parity 
Sets parity bit to one 
Specifies no parity; parity bit is omitted 
on output, and accepted as data on 
input 
Defaults: Factory = 4 

Power-Up = Saved in memory 
Omitted = 

The SET PORT PARITY command determines whether 
characters sent to the specified port have their parity bits 
set, and if so, how the parity is set. 

NOTE 

The meanings of the some of the parity-mode 
parameter settings in this command are NOT the 
same as those in the SET PARITY command. 



Low Parity. If parity-mode is set to zero, then low parity is 
used at the specified port. Each character includes a parity 
bit. The terminal transmits this bit as a "0" and ignores this 
bit in characters it receives from this peripheral port. 

Odd Parity. If parity-mode is 1 , then odd parity is used at the 
specified peripheral port. Each character (or other six-, 
seven-, or eight-bit data byte) includes a parity bit. In trans- 
mitting characters to this port, the terminal sets the parity bit 
to 1 or 0, whichever is needed to give an odd number of "1 " 
bits (not counting the start and stop bits). The terminal 
checks for odd parity (that is; for an odd number of "1 " bits 
not counting the start and stop bits) in characters received 
from this port. 

Even Parity. If parity-mode is 2, then even parity is used at 
the specified port. Each transmitted character includes a 
parity bit. The parity bit is 1 or 0, whichever is necessary to 
give an even number of "1 " bits (not counting the start and 
stop bits). The terminal checks for even parity in characters 
received from this port. 

High Parity. If parity-mode is 3, then high parity is used at 
the specified port. Each character includes a parity bit. The 
terminal always transmits this bit as a " 1 ". The terminal 
ignores the parity bit in characters received from this port. 

None Parity. If this parameter is 4, the parity bit is omitted 
on output and accepted as data on input. 

For normal operation with the ASCII character set, there 
should be seven data bits, one parity bit, and one or two 
stop bits, depending on your host. Therefore, the SET 
PORT PARITY command should have a parity setting of 0, 
1,2, or 3. 
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SET PORT STOP BITS 

Sets the number of stop bits and the number of data bits in 
characters sent to the specified port. 

Host Syntax 



E cPB port-identifier 

number-of-stop-bits 
number-of-data-bits 



Setup Syntax 



PBITS port-identifier 

n u mber-of-stop-bits 
number-of-data-bits 



port-identifier: string; must be one of the following: 
PO: Specifies Peripheral Port 
P1 : Specifies Peripheral Port 1 

number-of-stop-bits: integer; specifies the number of stop 
bits in characters sent to the specified port. Must be 1 or 2. 
Defaults: Factory = 2 

Power-Up = Saved in memory 

Omitted = Error 

number-of-data-bits: integer; specifies the number of data 
bits in characters sent to the specified port. Must be 5, 6, 7 
or 8. This count does not include the parity bit, whose pres- 
ence or absence is determined by the SET PORT PARITY 
command. 
Defaults: Factory = 8 

Power-Up = Saved in memory 

Omitted = Error 

This command sets the number of stop bits and data bits in 
characters sent between the terminal and the specified 
peripheral port. 

Each character has a start bit, which is always 0. After the 
start bit come from five to eight data bits; the number of data 
bits is determined by the SET PORT STOP BITS command. 
After the data bits comes the parity bit; this bit may be omit- 
ted, depending on the most recent SET PORT PARITY 
command. After the parity bit come one or two stop bits. The 
number of stop bits is determined by the most recent SET 
PORT STOP BITS command. The stop bits are always 1 . 



SET PROMPT STRING 

Specifies the string that initiates the terminal's Prompt 
mode. 

Host Syntax 



E cNS prompt-string 



Setup Syntax 



PROMPTSTRING prompt-string 



prompt-string: integer array of small integers (delimited 
character string in Setup syntax). Each integer must be in 
the range from through 1 27; each is the ADE of an ASCII 
character. The maximum length of the string defined by this 
parameter is 1 characters. 
Defaults: Factory = Empty array 

Power-Up = Saved in memory 

Omitted = Empty array 

This command defines the string that the terminal recog- 
nizes as a prompt string from the host. 

In Setup mode you can enter either a delimited string of 
ASCII characters or a series of ADEs. ADEs less than ten 
must be preceded by a zero. For example, to specify a Back 
Space character, use the ADE 08; the character 8 would be 
interpreted as the numeral 8 with ADE 56. 

See the Communications section for an explanation of 
Prompt mode. 
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SET QUEUE SIZE 

Specifies the size (in bytes) of the terminal's input queue. 
Host Syntax 



E cNQ queue-size 



Setup Syntax 



QUEUESIZE queue-size 



queue-size: integer; indicates the size in bytes of the input 
queue; must be in the range 1 through 65535. 
Defaults: Factory = 300 

Power-Up = Saved in memory 

Omitted = Error 

This command reserves part of the terminal's memory for 
use as an input queue for data coming from the host. Data 
from the host is stored in the input queue until it can be 
processed by the terminal. If the input queue fills up and the 
terminal is not using a flagging mechanism, the terminal 
simply discards incoming data until there is more room in 
the queue. See the Communications section for details. 

Specifying a very large input queue may affect the termi- 
nal's ability to store and display graphics information. Spec- 
ifying a very small input queue may cause data to be lost 
when the input queue overflows. 



SET REPORT EOM FREQUENCY 

Specifies how often the terminal sends EOM indicators to 
the host. 

Host Syntax 



E cIM EOM-frequency 



Setup Syntax 



REOM EOM-frequency 



EOM-frequency: integer; specifies whether EOM indicators 
should be sent more or less frequently in reports to the host. 
"More frequently" means at the end of each part of the 
message; "less frequently" means only when needed to 
prevent the maximum line length from being exceeded. 
Valid values are: 
Host Setup 

Less frequently 

1 1 More frequently 
Defaults: Factory = 1 

Power-Up = 1 
Omitted = 1 

This command controls how frequently the terminal inter- 
sperses EOM indicators among the characters that com- 
prise a "report message" that the terminal sends to the host 
computer. 

Generally speaking, setting the EOM-frequency to 1 (more 
frequent) causes a long message to be broken into separate 
lines of text for each part of the report. For instance, each 
GIN REPORT within a GIN REPORT SEQUENCE would 
occupy a separate line of text, terminated with an EOM 
indicator. 

Setting the EOM-frequency to (less frequent) permits 
several parts of a report to fit on the same line of text. For 
instance, several GIN Reports could fit on the same line. 
The line is terminated with an EOM indicator only when the 
terminal's maximum line length is about to be exceeded. 

EOM Indicators. The EOM indicator (end-of-message indi- 
cator) serves to mark the end of a "line of text" in data being 
sent to the host. 

The EOM indicator is always the current end-of-line string, 
as defined by the most recent SET EOL STRING command. 
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SET REPORT MAX LINE LENGTH 

Specifies the maximum number of characters, within a iine, 
the terminal sends to the host. 

Host Syntax 



E cIL max-line-length 



Setup Syntax 



RLINELENGTH max-iine-iength 



max-line-length: integer; specifies the maximum number of 
characters per line in reports sent to the host. Setting this 
parameter to zero disables the maximum-line-length fea- 
ture. Valid vaiues range from through 65535. 
Defaults: Factory = 

Power-Up = 

Omitted = 

This command sets the maximum line length for report 
messages which the terminal sends to the host computer. It 
also determines how frequently the terminal intersperses 
EOM indicators among data being transferred to the host in 
a PLOT command. 

EOM Indicators. The terminal uses EOM indicators (end-of- 
message indicators) to force the end of a line of text in data 
it sends to the host. The terminal's EOM indicator is always 
the same as its EOL string, set by the SET EOL STRING 
command. 

Report Messages. If the terminal has a report to send to the 
host, and that report would cause the maximum line length 
to be exceeded, then the terminal inserts an EOM indicator 
into the report. The EOM indicator serves to terminate the 
current line of text. 

The exact places where EOM indicators may be inserted 
are described in the syntax of the particular report type. For 
details, see the description of the individual reports. 



Other Data Sent to the Host. When the terminal sends data 
to the host in response to a plot command, it intersperses 
EOM indicators in that data, so as to break the data into 
"lines of text." Each such line of text has the maximum line 
length, as determined by the SET REPORT MAX LINE 
LENGTH command. 

This feature is to accommodate host computers that cannot 
reliably accept lines of more than a certain number of char- 
acters. The feature can be disabled by setting the terminal's 
maximum line length to zero. 

NOTE 

Even if the data being transferred already contains 
c r characters (or other EOM characters), the terminal 
still inserts a c r (or other EOL string) after every max- 
line-length characters of data. 

Therefore, if you will be transferring data that is 
already broken into individual lines of text, you 
should set the terminal's max report line length to 
zero, thereby disabling the "maximum line length " 
feature. (Alternatively, you can set the EOL string to 
the empty string.) 
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SET REPORT SIG CHARACTERS 

Assigns signature characters used within report messages 
that the terminal sends to the host. 

Host Syntax 



E cIS report-type-code 
signature-character 
terminal-signature-character 



Setup Syntax 



RSIGCHARS report-type-code 

signature-character 
terminal-signature-character 



report-type-code: integer; -3 to -1 , or a valid GIN device 
function. If this is a GIN device-function code, then the 
signature characters defined in this command will be used 
in GIN REPORT SEQUENCES for that device-function 
code. If this parameter is -3, then these signature charac- 
ters are used in non-GIN report messages. If the parameter 
is -2, these signature characters are used only when 
responding to REPORT GIN POINT: -2 commands. If the 
parameter is -1 , then these signature characters are used 
in all report messages (both GIN reports and non-GIN 
reports). 
Defaults: Omitted = 



This command assigns the signature characters to be used 
within report messages that the terminal sends to the host 
computer. 

The number -1 specifies "all reports" — inquiry reports 
and reports for all GIN device-function combinations. 

NOTE 

If GIN is enabled for more than one device at a 
time, then, different signature-characters and ter- 
minal-signature-characters are required for each 
enabled GIN device. This is necessary in order that 
the host computer can parse the interleaved GIN 
Report Sequences occurring when more than one 
GIN device is active. 

Also, if non-GIN reports are requested while GIN 
is enabled, then different signature-characters and 
terminal-signature-characters are needed to distin- 
guish non-GIN reports from GIN reports. 

On power-up, all signature characters are initialized to N u. 



signature-character: integer; the numeric equivalent of the 
ASCII character which is to be used as the signature-charac- 
ter in reports of the specified type. If the signature-character 
is set to N u — numeric equivalent of zero — then that signa- 
ture-character is omitted from reports sent to the host. 
Defaults: Factory = 

Power-Up = 

Omitted = 

terminal-signature-character: integer; specifies the charac- 
ter to be used as the terminal-signature-character in reports 
of the specified type. If the terminal-signature-character is 
V then it is omitted in reports sent to the host. 
Defaults: Factory = 

Power-Up = 

Omitted = 
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SET SEGMENT CLASS 

Alters the classes that a segment is assigned to for use in 
segment class matching operations. 

Host Syntax 



E cSA segment-number 
removal-array 
addition-array 



Setup Syntax 



SGCLASS segment-number 
removal-array 
addition-array 



segment-number: integer; names the segment whose 
classes are being altered. Valid values tor segment-number 
are: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

1 — 32767 A specific segment 
Defaults: Omitted = Error 

removal-array: integer array; lists the segment classes from 
which the specified segment is removed. Valid values for 
inclusion in removal-array are: 
-1 All classes 

1—64 A specific ciass 

Defaults: Factory = Empty array 
Power-Up = Empty array 
Omitted = Empty array 

addition-array: integer array; lists the segment classes to 
which the specified segment is added. Valid values for inclu- 
sion in addition-array are: 
-1 All classes 

1—64 A specific class 

Defaults: Factory = Empty array 
Power-Up = Empty array 
Omitted = Empty array 

Each segment belongs to a set of classes. This command 
alters this set by first removing the segment from the 
classes specified in removal-array and then adding the 
segment to the classes specified in addition-array. Remov- 
ing a class that is not in a segment's set, or adding a class 
that is already there, does not cause an error. 



SET SEGMENT DETECTABILITY 

Sets the detectability of a segment. 
Host Syntax 



E cSD segment-number 
detectability 



Setup Syntax 



SGDETECT segment-number 
detectability 



segment-number: integer; names the segment whose detec- 
tability is being set. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing ciass 

-2 The default for segments not yet defined 

-1 All segments 

1—32767 A specific segment 
Defaults: Omitted = Error 

detectability: integer (keyword in Setup syntax); specifies 
whether a segment can be Picked in a GIN Pick operation or 
not. Must be one of the following: 
Host Setup 

no Can't be Picked 

yes Can be Picked 

Factory = 1 

Power-Up = 1 

i*-» :±j. I f\ 




1 

Defaults 



If a detectability of 1 is specified, and the segment is visible 
in the current view, it is Picked when the Pick function is 
enabled. If is specified, the segment is not Picked. 

If graphics input (GIN) is in progress and the segment speci- 
fied is being used as the GIN cursor, this command has no 
effect. A segment is not Picked when it is being actively 
used as a GIN cursor. 
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SET SEGMENT DISPLAY PRIORITY 

Sets the display priority of a specified segment. 
Host Syntax 



E cSS segment-number 
priority-number 



Setup Syntax 



SGPRIORITY segment-number 
priority-number 



On power-up, the default priority for new segments is 0, 
unless the display priority for segment -2 is set to a different 
number by SET SEGMENT DISPLAY PRIORITY command. 

Upon redisplay (when an invisible segment is made visible, 
or when a view is renewed), the segments are displayed in 
priority order, so that the segment(s) last displayed are 
those with the highest display priority. For instance, if Seg- 
ment 56 has a priority number of 1 , and Segment 38 has 
priority number of 2, Segment 38 is displayed last and 
appears to be in front of Segment 56. 

For segments that are assigned the same display priority 
number, the order of display and the order of Picking are not 
defined, and may be different on different Tektronix termi- 
nals. 



segment-number integer; names the segment for which a 
display priority is being set. Valid values for segment-num- 
ber axe: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

1 — 32767 A specific segment 
Defaults: Omitted = Error 

priority-number: integer; specifies the display priority of the 

specified segment. Must be in the range -32768 through 

32767. 

Defaults: Factory = 

Power-Up = 

Omitted = 



NOTE 

During a graphics input Pick operation, the display 
priority of segments affects which of several eligible 
segments will be Picked. (An eligible segment is a 
visible, detectable segment, part of which falls 
within the current pick aperture.) The eligible seg- 
ment with the highest priority is the one that will be 
Picked. 
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SET SEGMENT HIGHLIGHTING 

Turns highlighting on or off for specified segments. 
Host Syntax 



E cSH segment-number 
highlighting 



Setup Syntax 



SGHIGHLIGHT segment-number 
highlighting 



segment-number: names the segment for which highlighting 
is being specified. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

1—32767 A specific segment 
Defaults: Omitted = Error 

highlighting: integer (keyword in Setup syntax); specifies 
whether a segment is highlighted (blinks) or not. 
Host Setup 

no Turns off the blink feature 

1 yes Turns on the blink feature 
Defaults: Factory = 

Power-Up = 
Omitted = 

Highlighting a segment makes it blink by turning the illumi- 
nated pixels off and on. Segment highlighting is performed 
regardless of the current fixup level. An open segment does 
not blink, but will start blinking when it is closed. 

NOTE 

If there are many segments, or complex segments 
with many pixels, the highlighting process may be 
very slow. In that case, you may find it advanta- 
geous not to use the SET SEGMENT HIGH- 
LIGHTING command. Instead, you can place the 
segments to be highlighted in a different view with a 
viewport on another surface, and blink that surface 
with the SET SURFACE VISIBILITY command 
with a parameter value of 2. 



SET SEGMENT IMAGE TRANSFORM 

Scales, rotates, and positions a specified segment. 
Host Syntax 



E cSI segment-number 
x-scale-factor 
y-scale-factor 
rotation-angle 
position 



Setup Syntax 



SGTRANSFORM segment-number 
x-scale-factor 
y-scale-factor 
rotation-angle 
position 



segment-number: integer; names the segment for which an 
image transform is being specified. Valid values for seg- 
ment-number are: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

1 — 32767 A specific segment 
Defaults: Omitted = Error 

x-scale-factor: real; specifies the factor by which the seg- 
ment is scaled in the x-direction. Must be in the range 
-32767 through 32767. 
Defaults: Factory = 1.0 

Power-Up = 1.0 

Omitted = 0.0 

y-scale-factor: real; specifies the factor by which the seg- 
ment is scaled in the y-direction. Must be in the range 
-32767 through 32767. 
Defaults: Factory = 1 .0 

Power-Up = 1.0 

Omitted = 0.0 

rotation-angle: real; specifies the counterclockwise rotation 
angle, in degrees. (A negative number specifies a clockwise 
rotation.) Must be in the range -32767 through 32767. 
Defaults: Factory = 0.0 

Power-Up = 0.0 

Omitted = 0.0 
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position: xy-coordinates; specify the position in terminal 
space where the segment's pivot point is to be located. Both 
x and y must be in the range through 4095. 
Defaults: Factory = (0,0) 

Power-Up = (0,0) 

Omitted = (0,0) 

The SET SEGMENT IMAGE TRANSFORM command trans- 
forms the segment as follows: 

1 . First, the segment is scaled in the x- and y-directions by 
the amounts specified by the x- and y-scale factors. A 
negative scale factor indicates an inversion about the 
appropriate axis. 

2. Next, the segment is rotated counterclockwise about its 
pivot point by the number of degrees specified in the 
rotation parameter. If this parameter is negative, then 
the segment is rotated clockwise. 

3. Finally, the segment is moved (translated) so that its 
pivot point is at the position specified by the position xy 
parameter. 

Image transform operations are not cumulative. They 
always start at the size and position of the original segment 
definition. 



After the scaling, rotation, and positioning has occurred, 
any parts of the segment that extend outside the current 
window are not displayed. 

NOTE 

When using SET SEGMENT IMAGE TRANS- 
FORM or SET SEGMENT POSITION, avoid 
positions that extend segment parts to x ory coor- 
dinates greater than 8091 or less than -4096. Seg- 
ments extending that far outside the normal to 
4095 terminal space may not be displayed properly. 

If a segment is being used as the graphics cursor for a GIN 
operation, moving that segment with the SET SEGMENT 
IMAGE TRANSFORM command does not change the cur- 
rent graphics input location. The next time the operator 
moves the joydisk (or other GIN device), the graphics input 
location is changed and the segment's pivot point is moved 
to that new graphics input location. 

If a segment's position is changed by the SET SEGMENT 
POSITION command, or by using the segment as a GIN 
cursor, then the current image transform for that segment is 
updated to reflect the change. 



The current fixup level determines how soon the display is 
updated to show the new position of the transformed seg- 
ment (see SET FIXUP LEVEL for details). 

Specifying for segment-number is not allowed. (Segment 
refers to the crosshair cursor, which cannot be rotated or 
scaled. If you want to change the position of Segment 0, use 
the SET SEGMENT POSITION command.) 

Specifying -2 for segment-number allows you to set the 
image transform parameters for segments which have not 
yet been defined. However, if the x- and y-scale factors are 
not unity, if the rotation angle is not zero, or if the position 
parameter is not the same as the current pivot point, then a 
segment being defined will not be displayed until an END 
SEGMENT command terminates the segment definition. 
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SET SEGMENT POSITION 

Moves the pivot point of a segment to a specified position in 
terminal space. 

Host Syntax 



E cSX segment-number 
position 



Setup Syntax 



SGPOSITION segment-number 
position 



segment-number: integer; names the segment whose posi- 
tion is being specified. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

The crosshair cu rsor 

1 — 32767 A specific segment 
Defaults: Omitted = 

position: xy-coordinate; specifies the position in terminal 
space of the segment's pivot point. Both x and y must be in 
the range through 4095. 
Defaults: Factory = (0,0) 

Power-Up = (0,0) 

Omitted = (0,0) 

A segment number in the range from i to 32767 specifies a 
segment which has previously been defined with BEGIN 
SEGMENT and END SEGMENT commands. An error is 
detected if the specified segment does not exist. 



Normally, when a segment is defined, its position is set to 
the same location as its pivot point (set by the most recent 
SET PIVOT POINT command). However, you can issue a 
SET SEGMENT POSITION command in which segment- 
number is -2 and position specifies a different location from 
the current pivot point. 

Issuing a SET PIVOT POINT command cancels the effect of 
any previous SET SEGMENT POSITION commands for 
Segment -2. 

If part of a segment extends outside the current window, 

tUnn +U.-1+ !-.«-».-+ j-\f tka eonmont ie nnt rlienlauoH 
ii ici i n icii pai i. vi ii i© -3«*yi ■"-" ■«■ ■*■* ■ "-"■ «.wf/-w/>/«- 

A segment's position may also be changed by the SET 
SEGMENT IMAGE TRANSFORM command, or by using 
the segment as the graphics input cursor. 

If the segment specified is being used as the graphics cur- 
sor in a GIN operation, then the segment's position is 
changed by the SET SEGMENT POSITION command, but 
the current graphics input location is not updated. The 
graphics input location will be updated, and the segment 
serving as the graphics cursor will be moved, the next time 
the operator moves the joydisk (or other graphics input 
device). 
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SET SEGMENT VISIBILITY 

Sets the visibility attribute of a specified segment(s). 
Host Syntax 



E cSV segment-number 
visibility 



Setup Syntax 



SGVISIBILITY segment-number 
visibility 



segment-number: integer; names the segment whose visibil- 
ity is being specified. Valid values for segment-number are: 

-3 All segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 All segments 

The crosshair cursor 

1 — 32767 A specific segment 
Defaults: Omitted = 

visibility: integer(keyword in Setup syntax); specifies 
whether a segment is visible in the current view or not. Must 
be one of the following: 
Host Setup 

no Makes segment invisible 

1 yes Makes segment visible 
Defaults: Factory = 1 

Power-Up = 1 
Omitted = 



If a visibility of 1 (visible) is specified, the segment appears 
in the mode specified by the most recent SET SEGMENT 
WRITING MODE command for that segment. 

Segments are automatically visible only in the view in which 
they are created; however, segments exist in all views, but 
must specifically be made visible in any view other than the 
one in which they are created. 

"The view in which a segment is created" means the cur- 
rently selected view at the time the END SEGMENT com- 
mand terminates the segment definition. 

The default for new segments is visible. This may, however, 
be altered by a SET SEGMENT VISIBILITY command for 
Segment -2. 

NOTE 

When GIN is enabled, the terminal saves the visibil- 
ity attribute for the segment which is to be used as 
the graphics cursor. That segment is then made 
visible. When GIN is disabled, the saved value of 
the visibility attribute is restored to the segment 
which acted as the graphics cursor. 

Therefore, any SET SEGMENT VISIBILITY 
commands, which may be issued for the graphic 
cursor while GIN is enabled, will cease to have 
effect when GIN is disabled. 



If a visibility of (invisible) is specified for a segment in the 
current view, the segment is made invisible either immedi- 
ately or the next time the screen is erased, depending on 
the fixup level specified in the most recent SET FIXUP 
LEVEL command. 
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SET SEGMENT WRITING MODE 

Selects the writing mode used when displaying a specified 
segment. 

Host Syntax 



E cSM segment-number 
writing-mode 



Setup Syntax 



SGMODE segment-number 
writing-mode 



segment-number: integer; names the segment for which a 
writing mode is being speeded, vaiiu vaiues «or segment- 
number are: 

-3 Aii segments that match the current match- 

ing class 

-2 The default for segments not yet defined 

-1 Al! segments 

The GIN cursor 

1 — 32767 A specific segment 
Defaults: Omitted = 

writing-mode: integer (keyword in Setup syntax); selects 
which writing mode is used. Must be one of the following: 
Host Setup 

1 set Selects Set mode 

2 XOR Selects XOR mode 
Defaults: Factory = 1 

Power-Up = 1 
Omitted = Error 



When XOR (exclusive OR) mode is selected, each pixel 
being written over is replaced by a pixel in a new color 
index. The new color index is a binary number which is the 
bit-by-bit "exclusive OR" of the bits in the old color index for 
that pixel and the corresponding bits of the current line 
index or text index. 

The XOR mode is convenient for writing images which may 
later need to be erased or re-positioned on the screen. This 
is because a line (or alphatext character, etc.) can be erased 
by writing over it again in XOR mode. (This property is a 
consequence of the Boolean logic theorem that (A XOR B) 



VHD D _ A \ 
j\\yi i u — r\.j 



If the segment specified is currently being used as a graphic 
cursor, then the SET SEGMENT WRITING MODE com- 
mand does not take effect until the current GIN (graphics 
input) operation is disabled. 

NOTE 

It's a good idea to issue a PAGE or RENE W 
VIEW command after changing a segment's writ- 
ing mode. This ensures that the viewport is updated 
to display the segment properly. 

If you don 't do this, and the current fixup level is 
five or more, it is possible that repositioning a 
segment may cause it to appear in more than one 
location on the screen. The remedy is for the host 
to issue a PAGE or RENEW VIEW command, or 
for the operator to press the G Eras key. 



When Set mode is selected to write an image of the seg- 
ment into the current viewport, each pixel being written over 
is set to the appropriate color index. The color index is the 
current line index for pixels which form the image of lines or 
graphtext, and the current text index for pixels which make 
up characters of alphatext or graphtext. The previous color 
index stored in the pixel is destroyed. 
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SET SNOOPY MODE 

Specifies whether or not the terminal is in Snoopy mode. 
Host Syntax 



E cKS snoopy-mode 



Setup Syntax 



SNOOPY snoopy-mode 



snoopy-mode: integer (keyword in Setup syntax); must be 
one of the foiiowing. 
Host Setup 

no Takes the terminal out of Snoopy mode 

1 yes Puts the terminal in Snoopy mode 
Defaults: Factory = (no) 

Power-Up = (no) 
Omitted = 1 (yes) 

When the terminal is in Snoopy mode, control characters 
that are normally used to control the terminal are displayed 
instead of executed (except for l f, which is displayed and 
causes a new display line). Characters that are normally 
filtered out of the host's data stream (such as prompt 
sequences) are still filtered and not displayed. You cannot 
execute commands from the host or keyboard when the 
terminal is in Snoopy mode. 

Snoopy mode cannot be terminated from the host; only the 
operator can do so. To terminate Snoopy mode, press the 
Cancel key or enter SNOOPY no in Setup mode. 



SET STOP BITS 

Specifies number of stop bits appended to each character 
the terminal transmits. 

Host Syntax 



E cNB number-of-stopbits 



Setup Syntax 



STOPBITS number-of-stopbits 



L 



number-oj-stopbits: integer; indicates the number of stop 
bits appended to each character the terminal transmits; 
must be 1 or 2. 
Defaults: Factory = 1 

Power-Up = Saved in memory 

Omitted = error 

See the Communications section for an explanation of 
stopbits. 
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SET SURFACE COLOR MAP 

Sets the color map for the graphics region. 
Host Syntax 



E cTG surface-number 
color-mixtures 



Setup Syntax 



CMAP surface-number 
color-mixtures 



surface-number: integer; names the surface for which color 
mixtures are being defined. -1 means a "super surface" 
consisting of all bit planes of all surfaces presently defined. 

color-mixtures: integer array; assigns a color mixture to one 
or more color indices. Each array is a quadruple (group of 
four). The first integer in each quadruple names a color 
index, while the following three integers specify the color 
mixture for that color index. The color mixture is specified in 
the HLS, RGB, or CMY coordinate system, according to the 
most recent SET COLOR MODE command. A blinking color 
can be specified by adding 1 000 to the third coordinate of 
an index. Table 5-16 (under SET SURFACE DEFINITIONS) 
lists the default color mixtures. 

Index is the background color, which is behind all the 
writing surfaces. 

The valid ranges for the first, second, and third coordinates 
in each system are, respectively: 

HLS: -32768 to 32767 
to 100 
to 100, or 1000 to 1100 

RGB and CMY: to 100 
to 100 
Oto 100, or 1000 to 1100 



The SET SURFACE COLOR MAP command sets the "color 
map" for the graphics region (the bit planes). It determines 
the mapping from that surface's color indices to particular 
color mixtures. It can be used to set the background color 
by setting the color index to 0. 

Use the SET DIALOG AREA COLOR MAP command to set 
the dialog area color map. 

The effect of the SET SURFACE COLOR MAP command 
continues until superseded by another SET SURFACE 
COLOR MAP command, or until surfaces are rsuciineu witu 
a SET SURFACE DEFINITIONS command. 



NOTE 

Unlike the 4105, color maps for the 4107 and 4109 
are not saved in nonvolatile memory. 

In this command, Surface -1 means a "super-surface" 
consisting of all bit planes in all surfaces presently defined. 
This is for use in advanced applications, such as controlling 
the exact color displayed where images on one surface 
overlap images on another surface. 

Adding 1000 to the third color coordinate of the index 
causes the color to blink by alternately becoming visible and 
invisible. For example, in the HLS color mode a normal red 
is indicated by (120,50,100), and a blinking red is given by 
(120,50,1100). 
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SET SURFACE DEFINITIONS 

Erases the screen and sets the number of surfaces and the 
number of bit planes in each surface. 

Host Syntax 



E cRD surface-defs 



Setup Syntax 



SDEFINITIONS surface-defs 



surface-defs: integer array; specifies the number of bit 

planes for each surface. 

Defaults: Factory = 4 (Surface 1 with four bit planes) 

Power-Up = 4 (Surface 1 with four bit planes) 

Omitted = Error RD1 1 

The SET SURFACE DEFINITIONS command erases the 
screen and sets the number of bit planes in each surface. 
Initially, all planes are allocated to one surface. Normal 
priority is front to back, with surface 1 being the front. 

The number-of-bit-planes in each surface determines the 
maximum color index which may be written into pixels on 
that surface. A surface with n bit planes is allowed color 
indices from 1 to2"-1. 

If more planes are specified than the terminal has, the 
excess specifications are ignored. 

Initializing Color Mixtures. The SET SURFACE DEFINI- 
TIONS command assigns a color mixture to each possible 
color index on each surface being defined. Table 5-1 6 lists 
the default mixtures. 



Table 5-16 
DEFAULT COLOR MIXTURES FOR SURFACES 



Color 


Color 
Mixture 


Color Coordinates 


Index 


H 


L 


S 





Transparent 











1 


White 





100 





2 


Red 


120 


50 


100 


3 


Green 


240 


50 


100 


4 


Blue 





50 


100 


5 


Cyan 


300 


50 


100 


R 


Manonta 


60 


50 


100 


7 


Yellow 


180 


50 


100 


8 


Red-Yellow (Orange) 


150 


50 


100 


9 


Green-Yellow 


210 


50 


100 


10 


Green-Cyan 


270 


50 


100 


11 


Blue-Cyan 


330 


50 


100 


12 


Blue-Magenta 


90 


50 


100 


13 


Red-Magenta 


90 


50 


100 


14 


Dark-Gray 





33 





15 


Light-Gray 





66 






Initializing Visibility. The SET SURFACE DEFINITIONS 
command causes each surface it defines to be visible, as if 
a SET SURFACE VISIBILITY command were issued for that 
surface. 

Initializing Surface Priorities. The SET SURFACE DEFINI- 
TIONS command arranges the surfaces in numerical order, 
from front to back. Surface 1 is in front; Surface 4 (if it 
exists) is in back. The background, whose color is set by 
SET BACKGROUND COLOR, is always behind all of the 
defined writing surfaces. You can change this ordering with 
the SET SURFACE PRIORITIES command. 
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SET SURFACE PRIORITIES 

Sets the priority of each writing surface. 
Host Syntax 



E cRN priorities 



Setup Syntax 




priorities: integer array; grouped in pairs. The first integer in 
each pair is a surface number, and the second integer of the 
pair is a priority number for that surface. Each surface is "in 
front of" ail surfaces that have a larger priority number than 
it, and "behind" all surfaces that have lesser priority num- 
bers. Valid surface and prioriiy values range from 1 through 4. 
Defaults: Factory =1,1 

Power-Up =1,1 

Omitted = Error RN11 

This command lists the surfaces, front to back; it deter- 
mines which of the transparent writing surfaces are "in 
front" of others, and which are "behind" other surfaces. 

Objects (especially filled areas) drawn on one surface will 
obscure objects drawn on a surface that is "behind" that 
surface (see the SET COLOR MODE command 
description). 

Special Cases, if two surfaces are assigned the same prior- 
ity, then the lower-numbered surface is deemed to be in 
front of the higher-numbered surface. If more than one 
priority is assigned to the same surface, then the last priority 
assigned that surface is the one which has effect. 

Default. On power-up, only Surface 1 exists. When multiple 
surfaces are defined (with the SET SURFACE DEFINI- 
TIONS command), the surface priorities are: Surface 1 is 
the front surface; Surface 2 is behind Surface 1 ; Surface 3 
is behind Surface 2; and Surface 4 is behind Surface 3. 



SET SURFACE VISIBILITY 

Sets the visibility of one or more surfaces without affecting 
surface priorities. 

Host Syntax 



E cRI surface-numbers-and-visibilities 



Setup Syntax 



SVISIBILITY surface-numbers-and-visibilities 



surface-numbers-and-visibilities: integer array; holds pairs 
of integers. The first integer in each pair is a surface num- 
ber. This must be in the range from 1 to 4. The second inte- 
ger in each pair specifies the visibility mode, and must be in 
the range from to 2: 

Invisible (no objects displayed) 

1 Visible 

2 Blinking (alternates between visible and invisible) 
Defaults: Factory =1,1 

Power-Up =1,1 
Omitted = Error RI11 

This command changes the visibility of one or more sur- 
faces without affecting surface priorities or the visibility 
attributes of any segments in the surfaces. Segments on an 
invisible surface cannot be Picked during a GIN operation. 
Visibility mode 2 causes a surface to blink, or alternate 
between being visible and being invisible at a rate of (0.75 
sec on, 0.75 sec off). Blinking indices and blinking su« laces 
blink in unison; highlighted segments do not necessarily 
blink in phase with each other or with other blinking graph- 
ics objects. 
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SET TAB STOPS 

Sets tab stop(s) at the specified position(s). 
Host Syntax 



E cKB tab-positions 



Setup Syntax 



TABS tab-positions 



tab-positions integer array (can also be a keyword in Setup 
mode) specifying one or more tab stops. The keyword all 
can be used in Setup mode to set tab stops at every column. 
Specify to clear all tab stops; specify -1 or all to set tab 
stops at every column; specify -2 to reset tab stops to fac- 
tory default. 

= 1 , 9, 1 7, 25, 33, 41 , 49, 57, 65, 73, 
80 

= Saved in memory 

= 



Defaults: Factory 

Power-up 

Omitted 



SET TEXT INDEX 

Specifies the color index for alphatext and graphtext in the 
graphics area. 

Host Syntax 



E cMT text-index 



Setup Syntax 



GTINDEX text-index 



text-index: integer; indicates color index for text in the 
graphics area. Must be in the range through 65535 (val- 
ues greater than 1 5 set text-index to 1 5). 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

This command sets the color index for all new text displayed 
in the graphics region. This includes all graphtext and 
alphatext displayed when the dialog area is disabled. This 
command does not change the color index of existing text. 

Alphatext displayed in the dialog area is not affected by this 
command. Use SET DIALOG AREA INDEX to set the color 
index of dialog area alphatext. 

If text is displayed on a surface that has fewer than 4 bit 
planes, and if you specify a text index greater than the maxi- 
mum index for that surface, the terminal uses the maximum 
index as the text index. The maximum color index for any 
particular surface is 2"-1 , where n is the number of bit 
planes assigned to that surface. 



5-116 



4107/4109 PROGRAMMERS 



SET TABLET HEADER CHARACTERS 

Selects the key characters used in GIN Stroke Reports. 

Host Syntax 

• ' | 

| E cIH character-set-selector i 

Setup Syntax 

«T»TaTrBATYH>T3f<WAPS r>ha.rn.r>t«T"-set-selector 



1 GINSHEADERCHARS character-set-selector i 



character-set-selector : integer (keyword in Setup syntax); 
must be one of the following : 



1-N I 



host; oe i/up 

letters Selects Z, J, and as key characters 

1 control Selects Z, % , and u s 
Defaults: Factory = 

Power-Up = 

Omitted = 

If character-set- selector is (letters in Setup) , the key 
characters in GIN Stroke Reports are: 

o Z, 1, 2, or 3 for the first point in a Stroke 
o j'for subsequent points in a Stroke 
o for the last point in a Stroke 

If character-set-selector is 1 (control in Setup), the key 
characters in GIN Stroke Reports are: 

o Z, 1, 2, or 3 for the first point in a Stroke 
o s b for subsequent points in a Stroke 
o u s for the last points in a Stroke 

For more details, see the GIN Stroke Report description under 
REPORT GIN POINT. 
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SET TRANSMIT DELAY 

Specifies the terminal's transmit delay between transmitting 
lines of text. 

Host Syntax 



E cND transmit-delay 



Setup Syntax 



AIVI I LftLH! li at 101 1 Ill'UCiay 



transmit-delay: integer; indicates the transmit delay in milli- 
seconds; must be in the range to 65535. 
Defaults: Factory = 100 

Power-Up = Saved in memory 

Omitted = 

After the terminal sends an end-of-message character, it 
pauses for a short time before resuming transmission. The 
length of this pause is set with the SET TRANSMIT DELAY 
command. This gives the host time to receive, verify, and 
process one line of text before receiving another. The actual 
delay time may be up to 33 milliseconds longer than the 
time specified by this command, because of the resolution 
of the terminal's internal timer. 

If the terminal is in Prompt mode, the terminal waits both 
until the transmit delay has elapsed and until it receives a 
prompt sequence before transmitting another line of text. 



SET TRANSMIT RATE LIMIT 

Specifies the effective transmit baud rate limit. 
Host Syntax 



E cNL rate-limit 



Setup Syntax 



XMTLIMIT rate-limit 



rate-limit: integer; specifies the terminal's transmit rate 
limit; must be in the range 1 10 through 65535. 
Defaults: Factory = 19200 

Power-Up = Saved in memory 

Omitted = Error 

!n some circumstances the host may not be able to process 
information as fast as the terminal can send it. This com- 
mand causes the terminal to pace its data transmission so 
that it does not exceed the indicated rate limit. 



4107/4109 PROGRAMMERS 



5-117 



4100-STYLE COMMANDS & REPORTS 
SET VIEW ATTRIBUTES 



SET VIEW ATTRIBUTES 

Sets the surface, wipe index, and border index for the cur- 
rent view. 



Host Syntax 



E cRA surface-number 
wipe-index 
border-index 



Setup Syntax 



VIEWATTRIBUTES 



surface-number 

wipe-index 

border-index 



Surface Number. If Surface is specified, the current sur- 
face for the view is left unchanged. If Surface -1 is speci- 
fied, then a super surface is used. This super surface 
consists of all bit planes on all of the presently defined sur- 
faces. If a surface is specified that does not exist, then an 
error occurs. (A surface does not exist if it was not defined in 
the most recent SET SURFACE DEFINITIONS command.) 

Wipe Index. If you specify a wipe index greater than the 
maximum index for the surface specified, the terminal uses 
the maximum index as the wipe index. The maximum color 
index for any particular surface is 2"-1 , where n is the num- 
ber of bit planes assigned to that surface. 

Border Index. If a border index greater than the maximum 
index for the surface is specified, the terminal uses the 
maximum index as the border index. (The border is drawn 
only if the BORDER key or SET BORDER VISIBILITY com- 
mand has made the border visible.) 



surface-number: integer; specifies the surface on which the 
view's viewport is located. Valid values are -1 through 4. 
Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

wipe-index: integer; the color index used for wiping (eras- 
ing) the viewport. Must be in the range through 65535. 
Defaults: Factory = 

Power-Up = 

Omitted = 

border-index: integer; the color index used for displaying a 

border around the viewport. Must be in the range through 

65535. 

Defaults: Factory = 1 

Power-Up = 1 

Omitted = 

The view most recently selected with the SELECT VIEW 
command or the View key is the current view. 
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SET VIEW DISPLAY CLUSTER 

Specifies a list of views that are to have identical windows. 
Host Syntax 



E cRQ view-numbers 



Setup Syntax 



VDISPLAYCLUSTER view-numbers 



J 



view-numbers: integer array; specifies which of the termi- 
nal's views are to have identical windows. Must be -2 
through 64: 

-2 Removes all views in the current view's 

cluster. 
-1 Clusters all 64 possible views together in 

one display cluster. (Any views that might 
later be created — with the SELECT VIEW 
command — will also be included in this 
display cluster.) 

Refers to the current view, as selected by 
the most recent SELECT VIEW command. 

1 — 64 Names a specific view; a view need not 

exist to be included in a view cluster. (Later, 
when the view is created with the SELECT 
VIEW command, it will be included in the 
view cluster.) 
Defaults: Omitted (Setup only) = Remove all views from 

all clusters 



Removing Specific Views From a Display Cluster. A view 
cannot belong to more than one display cluster. Thus, 
including a view in one cluster automatically removes it from 
any other clusters. 

Removing Ail Views From All Clusters. All views are 
removed from all clusters if the SET VIEW DISPLAY CLUS- 
TER command's integer array parameter is empty (if, in 
Host syntax, the array count is 0, or in Setup syntax, no view 
numbers are listed). 

Removing All Views From Only One Display Cluster. To 

remove aii views from a singie cluster: 

1 . Issue a SELECT VIEW command to select one of the 
views in the cluster. 

2. Issue a SET VIEW DISPLAY CLUSTER command 
containing the special view number, -2. 



In some circumstances, you may want to have several views 
with identical windows for their window-viewport trans- 
forms. The SET VIEW DISPLAY CLUSTER command lets 
you specify a list of views that are to have identical windows. 
Changing the window for any view in this cluster also 
changes the window for every other view in the cluster. Also, 
renewing any view in this cluster (RENEW VIEW or PAGE 
command, or G Eras or S Eras key) also renews every other 
view in the cluster. 
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SET VIEWPORT 

Sets the position of the current view's viewport in normal- 
ized screen coordinate space. 

Host Syntax 



E cRV first-corner 
second-corner 



Setup Syntax 



VIEWPORT first-corner 

second-comer 



first-corner: xy-coordinate; specifies the location of one 
corner of the current view's viewport in normalized screen 
coordinates. Values for x must be in range through 4095; y 
must be in range through 3071 . 
Defaults: Factory = (0,0) 

Power-Up = (0,0) 

Omitted = (0,0) 

second-corner: xy-coordinate; specifies location of the oppo- 
site corner of the viewport in normalized screen coordi- 
nates. Values for x must be in range through 4095; y must 
be in range through 3071 . 
Defaults: Factory = (4095,3071) 

Power-Up = (4095,3071) 

Omitted = (0,0) 

The two xy-coordi nates specify the positions of the lower- 
left and upper right corners of the viewport. (Actually, any 
two opposite corners will do; the terminal sorts the two x- 
coordinates and the two y-coordinates in the proper order.) 



Even though the viewport exists in 640 by 480 raster mem- 
ory space, the viewport corners are specified in 4096 by 
3072 normalized screen coordinate space. The terminal 
internally converts these normalized screen coordinates to 
raster memory space coordinates. 

NOTE 

Changing the viewport changes the location on the 
screen where existing segments are displayed. How- 
ever, segments that are visible when the viewport 
change occurs do not automatically move to their 
new screen locations. To make the terminal redraw 
segments at their new screen locations, you should 
issue a RENE W VIE WorPA GE command imme- 
diately after changing the viewport. 

If you don 't do this, and thefixup level is less than 
or equal to 4, then moving a segment may not cause 
that segment's old image to be properly removed 
from the screen. Multiple images of the segment 
will appear. The remedy is to issue RENEW VIEW 
or PAGE either immediately after the SET VIEW- 
PORT command or immediately after moving a 
segment. 
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SET WINDOW 

Sets the boundaries of the current view's window in terminal 
space. 

Host Syntax 



E cRW first-corner 

second-corner 



Setup Syntax 



WINDOW first-corner 

second-corner 



first-corner: xy-coordinate; specifies one corner of the win- 
dow in terminal space for the current view. Values for x and 
y must be in the range through 4095. 
Defaults: Factory = (0,0) 

Power-Up = Saved in memory 

Omitted = (0,0) 

second-corner: xy-coordinate; specifies the opposite corner 

of the window. Values for x and y must be in range through 

4095. 

Defaults: Factory =(4095,3130) 

Power-Up = Saved in Memory 

Omitted = (0,0) 

The window is the rectangular region in terminal space 
whose contents are displayed in a viewport on the screen. 

The parameters specify two opposite corners of the window. 
These can be any two opposite corners; the terminal sorts 
the two x-coordinates and the two y-coordinates in the 
proper order. 

Specifying a Window of Zero Width. If the rectangle speci- 
fied has zero width (that is, if the the two x-coordinates are 
equal), then the window (in terminal space) will have the 
same aspect ratio (ratio of height to width) as the corres- 
ponding viewport (in raster memory space). In that window, 
x-min (the x-coordinate of the lower-left corner) is the x- 
coordinate specified in the command. The value for x-max 
(the x-coordinate of the upper-right corner) is automatically 
chosen so that the window is the same shape as the 
viewport. 



Specifying a Window of Zero Height. Likewise, if the two 
corner parameters specify a rectangle of zero height (that 
is, if the two y-coordinates are equal), then the window (in 
terminal space) will have the same shape as the corres- 
ponding viewport (in raster memory space). In that window, 
y-min is the y-coordinate specified in the command's two 
parameters. The value for y-max is chosen so that the win- 
dow has the same shape as the viewport. 

Specifying the Default Window. If both width and height 
are zero (that is, if both lower-left and upper-right refer to the 
same point), then a window is selected which extends from 
x = through x = 4095, and from y = through y = 31 36. 

NOTE 

Changing the window changes the location on the 
screen where existing segments are displayed. How- 
ever, segments that are visible when the window 
change occurs do not automatically move to their 
new screen locations. To make the terminal redraw 
segments at their new screen locations, you should 
issue a RENE W VIE WorPA GE command imme- 
diately after changing the window. 

If you don 't do this, and thefixup level is greater 
than or equal to 4, then moving a segment may not 
cause that segment's old image to be properly 
removed from the screen. Multiple images of the 
segment will appear. The remedy is to issue 
RENE W VIE W or PA GE either immediately after 
the SET WINDOW command or immediately after 
moving a segment. 

Effect On Other Views in the Same View Display Cluster. 

Views may be grouped into view display clusters. (See the 
SET VIEW DISPLAY CLUSTER command for details.) If the 
current view belongs to a view display cluster, and a SET 
WINDOW command is issued, then that SET WINDOW 
command sets the window not only for the current view, but 
also for all other views in that cluster. 

Clipping. The terminal performs a window-viewport trans- 
form on each visible segment; that is, for each segment 
defined in terminal space coordinates, the terminal com- 
putes an image of that segment in 640 by 480 raster mem- 
ory space. The window coordinates (in terminal space) and 
the viewport coordinates (in raster memory space) together 
define this window-viewport transform. Those parts of the 
image in raster memory space which fall outside the current 
viewport are clipped (not displayed). 
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SET 4014 ALPHATEXT SIZE 

Selects between two alphatext character sizes. 
Host Syntax 



E c size-code 



size-code: specifies one of two sizes for alphatext. Must be 

one of four ASCII characters: 

8 or 9 Fits at least 80 characters on one line 

: or ; Fits at least 1 28 characters on one line 

This command allows the terminal to be compatible with 
earlier Tektronix terminals. It affects the terminal only when 
the dialog area is disabled. 

When using the 1 28 character-per-line size the terminal 
displays characters only in the US ASCII font. 



SET 4014 LINE STYLE 

Specifies line styles compatible with Tektronix 401 and 
4110 Series terminals. 

Host Syntax 



E c line-style-code 



line-style-code: single character; specifies one of the line 
styles shown in Figure 5-15. 

This command does the same thing as the SET LINE 
STYLE command. The line styie for iines, markers, and 
panel boundaries is set by the last SET LINE STYLE or SET 
4014 LINE STYLE, whichever occurred most recently. 

SET 4014 LINE STYLE sets line styles that are available on 
other Tektronix terminals. This lets you emulate other termi- 
nal's displays. 

Codes h through o indicate line styles that are displayed 
with a defocused beam on TEKTRONIX 4014, 4016, and 
41 1 4 terminals. The 41 07 and 41 09 terminals does not 
defocus these lines. 



Character Line Style 



a 
b 
c 
d 
e 
f 

g 

h 

i 
i 

k 
I 

m 
n 
o 



Emulated Terminals 

4014/4016 

4014/4016 

4014/4016 

4014/4016 

4014/4016 

4112/4113/4114 

4112/4113/4114 

4112/4113/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4014/4016/4114 

4893-16 



Figure 5-15. Line Style Codes. 



5-122 



4107/4109 PROGRAMMERS 



4100-STYLE COMMANDS & REPORTS 
4010HARDCOPY 



STATUS 



Displays the current parameter values for a command or 
cluster of commands.Setup Syntax 



STATUS name 



name: string; the Setup command name or command clus- 
ter name for which you want the current parameter values. 
To display the valid command names and command cluster 
names, enter STATUS (from Setup mode). 
Default: Omitted = All commands 



4010HARDCOPY 



Host Syntax 



This command has the same effect as pressing the S Copy 
key. 

To copy only the graphics area, press the Dialog key to 
make the dialog area invisible. After the copy starts, you 
can press the Dialog key to make the dialog area visible. 
This lets you use the dialog area while the copy is being 
made. 



If \ir\i i r>i^r\\i +!>*> r4ii-ilr\i-t r* mil rli irir^s* +1^*^ + irv*rt +1^** nnm > I** t^ a!**~* 

ii juu \s\jyy Li ic uicuv^y ai oct, uui ii iy U IC7 III I IC II IC ivugjy IS L/CIl IL^ 

made, the dialog area will not show your dialog with the 
host. 
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CODE CHARTS AND KEYBOARD MACROS 



Each code chart in this appendix contains one of the eight 
character sets available in the terminal. These character 
sets are defined in the ANSI X3.41 and ISO 2022 
documents. 

You can designate any two of the character sets as the GO 
and G1 sets and easily switch between them. The GO set is 
selected by sending a s i (Shift In) character to the terminal, 
which causes the GO character set to replace the current 
character set in the terminal. The G1 set is selected by 
sending a s o (Shift Out) character to the terminal, which 
causes the G1 character set to replace the current GO char- 
acter set in the terminal. Refer to the description of the SCS 
(Select Character Set), s i (Shift In), and s o (Shift Out) com- 
mands in the Screen Editing section of this manual for more 
information. 

Each optional keyboard has a character set that corres- 
ponds to its special characters. Plugging a keyboard into 
the terminal automatically selects this character set as both 
the GO and G1 character sets. For example, the North 



American keyboard selects the ASCII character set, while 
the Option 4G German keyboard selects the German char- 
acter set. However, this does not limit a keyboard to one 
character set, or limit a character set's use to one keyboard; 
all character sets are available for selection as the GO or G1 
set, regardless of which keyboard you attach to the 
terminal. 

At the end of this appendix are the code charts for the Sup- 
plementary and Rulings character sets. These character 
sets are available to all keyboards, but none of the key- 
boards automatically selects either of them. 

Each keyboard macro chart represents one of the six key- 
boards available with the terminal, and lists the macro num- 
bers invoked by each of the keys and key combinations. 
Each keyboard macro chart accompanies the code chart of 
the keyboard's corresponding character set. More informa- 
tion about macros and how they are defined and used can 
be found in the section called The Graphics Terminal, and in 
the DEFINE MACRO command description. 
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ASCII CHARACTER SET 

(Designated by Connecting the Standard North American Keyboard) 



CODE CHARTS & KEYBOARD MACROS 

ASCII 




DOWN 
-138 
-142 
-146 

-150 



Dialog 



Cance 



Se t up 



D Copy 
S Copy 



Fl 


F2 


F3 


F4 



F5 


F6 


F7 


FB 



■111 -112 -113 -114 

-117 -118 -119 -120 

-123 -124 -125 -126 

-129 -130 -131 -132 



128 129 130 131 

136 137 138 139 

-2 -3 -4 -5 

-10 -11 -12 -13 



132 133 134 135 

140 141 142 143 

-6 -7 -8 -9 

-14 -15 -16 -17 



D Eras 


{ 


! 


@ 


# 


$ 


V. 


A 


& 


* 


[ 


) 




+ 


} 


Rub 












SEros 


r 


! 


2 










7 


8 


Q 


.0 




~ 


1 


Out 




7 


a 


9 





Unshifted -115 91 49 50 51 52 53 54 55 56 57 48 45 61 93 127 

Shifted -121 123 33 64 35 36 37 94 38 42 40 41 95 43 125 -34 

Ctrl -127 27 49 50 51 52 53 54 55 56 57 48 45 61 29 -35 

Ctrl-Shifted -133 27 33 35 36 37 30 38 42 40 41 31 43 29 -36 



-62 -63 -64 -67 

-76 -77 -78 -81 

-90 -91 -92 -95 

-104 -105 -106 -109 





Esc 




~ |Q 


W |E 

i 
I 


R 


j 


Y 


U 


I |0 

i 


p 


\ 




Bock 
Space 




L I ne 
Feed 



4 b 6 , 



Unshifted 27 

Shifted -37 

Ctrl -38 

Ctrl-Shifted - 39 



124 113 119 

126 81 87 

124 17 23 

126 17 23 



101 



114 
82 
18 
18 



116 
84 
20 
20 



121 
89 
25 
25 



117 
85 
21 
21 



105 

73 

9 

9 



111 
79 
15 
15 



112 



16 
16 



92 
96 
28 
28 



-40 
-41 
-42 



10 
-43 
-44 
-45 



-59 
-73 
-87 



-60 
-74 



-61 
-75 
-89 



-66 
-80 
-94 





Tab 




Ctr I 


A 


S 


D 


F 


G 


H 


J 


K 


L 


: 


/ 


R« turn 



Unshifted 9 

Shifted -46 

Ctrl -47 

Ctrl-Shifted -48 



97 115 

65 83 

1 19 

1 19 



100 



102 

70 

6 



103 
71 

7 

7 



104 
72 



106 
74 
10 
10 



107 108 

75 76 

11 12 

11 12 



59 
58 
59 
58 



39 
34 
39 
34 



13 
-49 
-50 
-51 



o 




z 


X 


c 


V 


I B 


N 


M 


<r 


|> 


? 






r. nn5 


Sh i f f 
























Break 


Lock 










| 






5 


I " 


/ 







Unshifted 122 120 99 118 98 110 109 44 46 

Shifted 90 88 67 86 66 78 77 60 62 

Ctrl 26 24 3 22 2 14 13 44 46 

Ctrl-Shifted 26 24 3 22 2 14 13 60 62 



47 
63 
47 

63 

SPACEBAR 



-116 
-122 
-128 

-134 



Unshifted 32 

Shifted - 52 

Ctrl - 53 

Ctrl-Shifted -54 



Figure A-1 . North American Keyboard Macro Chart. 



-101 


-102 


-103 


-108 


I 


2 


3 




Enter 


-56 


-57 

-71 
-85 
-99 


-58 

-72 

-86 

-100 


-70 
-84 
-98 





-55 
-69 
-83 

-97 



-65 

-79 

-93 

-107 



J0 





-68 
-82 
-96 
-110 





B7 
B6 


B5 


"% 


8 », 


1 1 01 

I 1 


'•. 


1 «, 


^0 


N 


BITS 

B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














W 


A^ 


S P 

32 


@ 

48 1 64 


P 

80 


\ 
96 


p 

112 











1 


L?y 


D i„ 


! 1 

33\ 49 


A 

65 


L 


a 

97 


q 

113 








1 





S 


Do " 2 

18 34' 50 


B 

66 


R 

82 


b : r 

98\ 114 








1 


1 


EX 

3 


d 3 : # 3 

19, 35, 51 


c 

67 


s 

83 


c ! s 

99i 175 





1 








Et D 4 $ 4 D 

4l 20 36: 52! 68 


T ! d 1 t 

84i 100 116 





1 


1 


En l\l K % 5 E U e \ u 

5 21' 37 53! 69! 85: 707 117 





1 


1 





A« ; Sy & ; 6 F 

6 22; 38 54! 70 


V f ! v 

86 102\ 118 


111 


bl e b / 

7 23\ 39 


1 

55 


G 

71 


W j g 

87! 103 


w 

119 


1J0 
I I 








BS ! C N ! ( 

8| 24\ 40 


8 

56 


H j X l h 

72i 88 1 104 


X 

120 










1 


Ht 1 e m i ) | 9 

9 25 41] 57 


I 

,3 


Y 

89 


i 

105 


y 

121 







1 





TO 26 42 


58 


J 

74 


z 

90 


j 

106 


z 

122 







1 


1 


V T I E C j + 

in e. 1 ! **o 


; K 

COl 7C 


[ 

91 


k 

m7 


{ 
101 




1 |0 


F F„ 


2S! 44 


< L \ 1 ! 

60\ 76\ 92 1 108\ 124 




1 





1 


\K 


Gs - = ! M 1 m ' } 

29i 45i 6H 77, 93 \ 1091 125 




1 


1 





[K 


30 


> N A n 

46l 62! 78^ 94 110 


126 




1 


1 


1 


UL 


us 

I 31 


/ I ? ! j _ 

47] 63', 79\ 95 




111 


Dt 

127 



(4526)4893-18 



Figure A-2. ASCII Character Set Code Chart 
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UNITED KINGDOM CHARACTER SET 

(Designated by Connecting the Option 4A Keyboard) 



CODE CHARTS & KEYBOARD MACROS 
UNITED KINGDOM 




Unshifted 
Shifted 
Ctrl 
Ctrl-Shifted 



DOWN 
-138 
-142 
-146 
-150 



6 Eros 



Dialog 



Cancel 



5s tup 



D Copy 
S Copy 



Meni. 



Fl 


F2 


F3 


F4 



-111 -112 -113 -114 

-117 -118 -119 -120 
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-129 -130 -131 -132 



128 129 130 

136 137 138 

-0 _3 -A 

-10 -11 -12 



131 
139 



-13 



D Eras 


{ 


! 


@ 


£ 


$ 


'/. 


A 


& 


X 


I 


) 




+ 


} 


Rub 


5 Eras 


c 


I 


2 


3 


4 


5 


6 


7 


8 


9 








- 


1 


Out 
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Shifted -121 123 33 64 35 36 37 94 38 42 40 41 95 43 125 -34 

Ctrl -127 27 49 50 51 52 53 54 55 56 57 48 45 61 29 -35 

Ctrl-Shifted -133 27 33 35 36 37 30 38 42 40 41 31 43 29 -36 
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Ctrl-Shifted 26 24 3 22 2 14 13 60 62 
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63 

SPACEBAR 
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Shifted -52 

Ctrl - 53 

Ctrl-Shifted -54 



Figure A-3. United Kingdom Keyboard Macro Chart. 
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1 n !o 


so 

14 


30 


46 


> 

62 


N 

78 


A 

94 


n 

170 


726 


1 11 1 


si 

15 


u s, 

31 


/ 

47 


7 

63 




79 


~ 95 




111 


Dt 

727 



(4526)4893-20 



Figure A-4. United Kingdom Character Set Code Chart 



A-4 



4107/4109 PROGRAMMERS 



FRENCH CHARACTER SET 

(Designated by Connecting the Option 4B Keyboard) 



CODE CHARTS & KEYBOARD MACROS 

FRENCH 




UP 
-136 
-140 
-144 
-148 



LEFT 
-137 
-141 
-145 
-149 



DOWN 
-138 
-142 
-146 
-150 



6 Eras 
Dia log 


Ca n c « I 
So tup 


D Copy 

S Copy 


ww riU 



C" 1 
i I 


1 £_ 


F3 


F4 



-111 

-117 
-123 
-129 



-112 -113 -114 

-118 -119 -120 

-124 -125 -126 

-130 -131 -132 



128 129 130 131 

136 137 138 139 

-2 -3 -4 -5 

-10 -11 -12 -13 



D Eras 
5 Eras 



7 



<2 



Unshifted -115 36 

Shifted -121 42 

Ctrl -127 36 

Ctrl-Shifted -133 42 



38 

49 
38 
49 



123 


34 


39 


50 


51 


52 


27 


34 


39 


50 


51 


52 



40 



40 
53 



93 
54 
29 
54 



125 
55 
29 
55 



33 
56 
33 
56 



92 
57 
28 
57 



64 

48 



48 



41 
91 
41 
27 



45 
95 
45 
31 



35 
96 
35 
28 



127 
-34 
-35 
-36 



U 



A 



Esc 



Unshifted 9 

Shifted -46 

Ctrl -47 

Ctrl-Shifted -48 



62 
60 
62 



97 
65 

1 
1 



122 
90 
26 
26 



101 

69 

5 

5 



114 
82 
18 
18 



116 
84 
20 
20 



25 
25 



117 


105 


111 


112 


94 


27 


85 


73 


79 


80 


126 


-37 


21 


9 


15 


16 


30 


-38 


21 


9 


15 


16 


126 


-39 



-40 

-41 
-42 







Unshifted 
Shifted 
Ctrl 
Ctrl-Shifted 



Ctr I 



10 
-43 

-44 
-45 



. O 

uaps 

Lock 



Q 



113 115 

81 83 

17 19 

17 19 



100 

68 

4 

4 



102 
70 



103 

71 

7 

7 



104 
72 



106 
74 
10 
10 



107 
75 
11 
11 



108 109 

76 77 

12 13 

12 13 



124 
37 

124 
37 



13 
-49 
-50 
-51 



wnj 
mi n 



w 



X 



IB 



+ 



MAJ 

ml n 



Unshifted 
Shifted 
Ctrl 
Ctrl-Shifted 



119 
87 
23 
23 



120 
88 
24 
24 



99 

67 
3 
3 



118 
86 
22 
22 



98 

66 

2 

2 



110 
78 
14 
14 



44 
63 
44 
63 



59 
46 
59 

46 



58 
47 
58 

47 



61 
43 
61 
43 

SPACEBAR 



Figure A-5. French Keyboard Macro Chart. 



-116 
-122 
-128 
-134 



Unshifted 32 

Shifted -52 

Ctrl -53 

Ctrl-Shifted - 54 



F5 


F6 


F7 


FB 


132 

140 
-6 

-14 


133 

141 

-7 

-15 


134 

142 

-8 

-16 


135 
143 
-9 

-17 


7 

1 • 


8 


q 


I 


-62 

-76 

-90 

-104 


-63 
-77 

-91 
-105 


-64 

-78 

-92 

-106 


-67 

-81 
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Figure A-6. French Character Set Code Chart 



4107/4109 PROGRAMMERS 



A-5 



SWEDISH CHARACTER SET 

(Designated by Connecting the Option 4C Keyboard) 



CODE CHARTS & KEYBOARD MACROS 
SWEDISH 




JOYDISK 



RIGHT UP LEFT 

Unshifted -135 -136 -137 

Shifted -139 -140 -141 

Ctrl -143 -144 -145 

■ )47 - 148 - 149 



oin-smnea 



DOWN 
-138 

-142 
-146 
-150 



G Eras 



Dialog 



Cance I 



Se t up 



D Copy 
5 Copy 



Fl 


F2 


F3 


F4 



-111 

-117 
-123 



-112 -113 -114 
-118 -119 -120 
-124 -125 -126 



-129 -130 



-131 -132 



128 129 130 131 

136 137 138 139 

-2 -3 -4 -5 

-10 -11 -12 -13 



Unshifted -115 

Shifted -121 

Ctrl -127 

Ctrl-Shifted -133 



D Eras 
S Er as 


A 


! 

I 


7f 

2 


# 
3 


a 

4 


5 


6 


/ 

7 


( 

8 


) 
9 





? 

+ 


\ 

i 


> 
< 


Rub 

Out 



126 
94 

126 
30 



49 
33 
49 
33 



50 
34 
50 
34 



51 
35 
51 
35 



52 
36 
52 
36 



53 
37 
53 
37 



54 
38 
54 
38 



55 

47 
55 
47 



56 
40 
56 

40 



57 
41 
57 
41 



48 
61 
48 
61 



43 
63 
43 
63 



39 
96 
39 
28 



60 
62 

60 
62 



127 
-34 
-35 
-36 



* 



Unshifted 27 

Shifted - 37 

Ctrl - 38 

Ctrl-Shifted - 39 



64 113 119 

42 81 87 

17 23 

42 17 23 



101 

69 

5 

5 



Back 
5pac« 



Li ne 

Feud 



114 
82 
18 
18 



116 
84 
20 
20 



121 



25 
25 



117 
85 
21 
21 



105 

73 

9 

9 



111 112 

79 80 

15 16 

15 16 



125 
93 
29 
29 



-40 
-41 
-42 



10 
-43 
-44 
-45 



Unshifted 9 

Shifted -46 

Ctrl -47 

Ctrl-Shifted -48 





Tab 




Ctr I 


A 


S 


D 


F 


G 


H 


J 


K 


L 


O 


A 


Re turn 



97 115 

65 83 

1 19 

1 19 



100 
68 

4 
4 
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70 



103 

71 

7 

7 



104 106 107 

72 74 75 

8 10 11 

8 10 11 



108 
76 
12 
12 



124 
92 
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28 
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27 
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13 
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Lock 
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Z 


X 
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V 
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■ 





Shi ft 


Br eak 



Unshifted 122 120 99 118 

Shifted 90 88 67 86 

Ctrl 26 24 3 22 

Ctrl-Shifted 26 24 3 22 



98 110 109 

66 78 77 

2 14 13 

2 14 13 



44 
59 
44 
59 



46 
58 
46 
58 



45 
95 

45 
31 

SPACEBAR 



-116 
-122 
-128 
-134 



Unshifted 32 

Shifted - 52 

Ctrl - 53 

Ctrl-Shifted - 54 



Figure A-7. Swedish Keyboard Macro Chart. 
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77 
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Figure A-8. Swedish Character Set Code Chart 



A-6 



4107/4109 PROGRAMMERS 



DANISH/NORWEGIAN CHARACTER SET 

(Designated by Connecting the Option 4F Keyboard) 



CODE CHARTS & KEYBOARD MACROS 
DANISH/NORWEGIAN 




DOWN 
-138 
-142 
-146 
-150 



p Era* 
Dialog 



Car 



Sat 



up 



D Copy 
S Copy 



F i 


r d. 


rr - z 
r o 


C" A 
1 *+■ 



•111 -112 -113 -114 

-117 -118 -119 -120 

-123 -124 -125 -126 

-129 -130 -131 -132 



128 129 130 131 

136 137 138 139 

-2 -3 -4 -5 

-10 -11 -12 -13 



D Eras 
S Eras 


A 


! 

I 


—1 
d- 


# 

3 


$ 
4 


7. 

5 


& 
6 


/ 

—I 
1 


( 

8 


) 




? 
+ 


\ 


> 


Rub 
Out 



Unshifted -115 126 49 50 51 52 53 54 55 56 57 

Shifted -121 94 33 34 35 36 37 38 47 40 41 

Ctrl -127 126 49 50 51 52 53 54 55 56 57 

Ctrl-Shifted -133 30 33 34 35 36 37 38 47 40 41 



48 



48 

61 



43 



43 
63 



39 
96 



60 127 

62 -34 

60 -35 

62 -36 





Esc 




@ 


Q 


W | E 


R 


T 


Y 


U 


I 





P 


A 




Back 
Space 




Li n« 
Feed 



Unshifted 
Shifted 
Ctrl 
Ctrl-Shifted 



27 
-37 
-38 



64 113 119 

42 81 87 

17 23 

42 17 23 



101 

69 

5 

5 



114 
82 

18 
18 



116 
84 
20 
20 



121 



25 
25 



117 
85 
21 
21 



105 

73 

9 

9 



111 112 125 

79 80 93 

15 16 29 

15 16 29 



-40 
-41 
-42 



10 
-43 

-44 
-45 





Tab 




Ctr I 


A 


S 


D 


F 


G 


H 


J 


K 


L 





/E 


Return 



Unshifted 9 

Shifted - 46 

Ctrl -47 

Ctrl-Shifted -48 



97 115 

65 83 

1 19 

1 19 



100 
68 

4 
4 



102 

70 

6 



103 

71 

7 
7 



104 
72 



106 
74 
10 
10 



107 
75 
11 
11 



108 

76 
12 
12 



124 
92 

124 
28 



123 
91 
27 
27 



13 
-49 
-50 

-51 



„ o 

Laps 
Lock 


Shi ft 


z 


X 


c 


V 


B 


N | M 


9 


. 





Shi ft 


Break 



Unshifted 122 120 99 118 

Shifted 90 88 67 86 

Ctrl 26 24 3 22 

Ctrl-Shifted 26 24 3 22 



98 110 109 

66 78 77 

2 14 13 

2 14 13 



44 
59 
44 
59 



46 
58 
46 
58 



45 
95 
45 

31 

SPACEBAR 



-116 
-122 
-128 
-134 



Unshifted 32 

Shifted -52 

Ctrl - 53 

Ctrl-Shifted - 54 



i *j 


ETC 


C — 7 
1 / 


C"0 


132 


133 


134 


135 


140 


141 


142 


143 


-6 


-7 


-8 


-9 


-14 


-15 


-16 


-17 


—I 

1 


8 




- 


-62 


-63 


-64 


-67 
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-77 
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-81 
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-91 
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-95 
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4 


5 


6 


i 


-59 
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-61 
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-73 
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-89 
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-103 


-108 


I 


2 


3 
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-56 

-70 


-57 
-71 


-58 
-72 




-84 


-85 


-86 




-98 


-99 


-100 




-68 








-82 








-96 







» 
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-55 
-69 
-83 
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-65 

-79 

-93 

-107 





B7 
B6 


B5 


'•. 
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\ 


X 


X 
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N 
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CONTROL 
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K 


S P 
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48 


64 


p 

80 


\ 

96 


p 
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1 
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I 

33 


1 

49 


A 

65 
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a 

97 


q 
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1 
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B 
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R 
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b 

98 


r 
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99 


s 
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84 


d 
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1 


5 


21 
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37 


5 

53 


E 

69 


u 

85 


e 
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u 
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1 


1 


Ak 

6 


Sy 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 
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V 
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7 


EB 

23 
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39 


7 

55 


G 

77 
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87 


g 
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w 
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( 

40 


8 

56 


H 

72 
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h 
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X 

720 










1 


H T S 


Em 

25 
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41 


9 

57 


I 

73 
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1 





LF 
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26 
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58 
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T7 


+ 
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Figure A-9. Danish/Norwegian Keyboard Macro Chart. 



Figure A-10. Danish/Norwegian Character Set Code Chart 
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GERMAN CHARACTER SET 

(Designated by Connecting the Option 4G Keyboard) 



CODE CHARTS & KEYBOARD MACROS 
GERMAN 




Unshifted 
Shifted 
Ctrl 
Gtri-Smftea 



DOWN 
-138 
-142 
-146 
-150 



G Co 


Stop 


D Kop 


Manu 


Dla lag 


Par am 


B Kop 





Fl 


F2 


F3 


F4 



-111 

■117 
-123 

-129 



-112 -113 -114 

-118 -119 -120 

-124 -125 -126 

-130 -131 -132 



128 129 130 131 

136 137 138 139 

-2 -3 -4 -5 

-10 -11 -12 -13 



D Ho 
B Lb 


A 
# 


! 

I 


2 


§ 
3 


$ 
4 


y. 

5 


& 

6 


/ 
7 


( 
B 


) 
9 





? 


\ 

/ 


X 

+ 


SI 



Unshifted 


-115 


35 


49 


50 


51 


52 


53 


54 


55 


56 


57 


48 


Shifted 


-121 


94 


33 


34 


64 


36 


37 


38 


47 


40 


41 


61 


Ctrl 


-127 


35 


49 


50 


51 


52 


53 


54 


55 


56 


57 


48 


Ctrl-Shifted 


-133 


30 


33 


34 





36 


37 


38 


47 


40 


41 


61 



126 
63 

126 
63 



39 
96 
39 
28 



43 
42 
43 
42 



127 
-34 
-35 
-36 



Unshifted 
Shifted 
Ctrl 
Ctrl-Shifted 





Esc 




> 
< 


Q 


W 


E 


R 


T 


Z 


U 


I 


o 


p 


u 




«t~ 




1 



27 
-37 
-38 
-39 



60 
62 



62 



113 
81 
17 
17 



119 
87 
23 
23 



101 



114 
82 
18 
18 



116 
84 
20 
20 



122 



26 
26 



117 
85 
21 
21 



105 

73 

9 

9 



111 112 

79 80 

15 16 

15 16 



125 
93 
29 
29 



8 

-40 
-41 
-42 



10 
-43 
-44 
-45 





f ■> 
Tab 




Ctr I 


A 


s 


D 


F 


G 


H 


J 


K 


L 


O 


A 


< — ' 



Unshifted 9 

Shifted -46 

Ctrl -47 

Ctrl-Shifted -48 



97 115 

65 83 

1 19 

1 19 



100 



102 

70 

6 

6 



103 

71 

7 

7 



104 106 107 

72 74 75 

8 10 11 

8 10 11 



108 124 

76 92 

12 12 

12 12 



123 
91 
27 
27 



13 
-49 
-50 
-51 



o 

Sper r 





Y 


X 


c 


V 


B 


N 


M 




„ 








Br «ak 



Unshifted 


121 


120 


99 


118 


98 


110 


109 


44 


46 


Shifted 


89 


88 


67 


86 


66 


78 


77 


59 


58 


Ctrl 


25 


24 


3 


22 


2 


14 


13 


44 


46 


Ctrl-Shifted 


25 


24 


3 


22 


2 


14 


13 


59 


58 



45 
75 
45 
31 

SPACEBAR 



Figure A-1 1 . German Keyboard Macro Chart. 



-116 
-122 
-128 
-134 



Unshifted 32 

Shifted -52 

Ctrl - 53 

Ctrl-Shifted -54 



-83 

-97 



-65 

-79 

-93 

-107 



F5 


F6 


F7 


FB 


132 

140 
-6 

-14 


133 

141 

-7 

-15 


134 

142 

-8 

-16 


135 

143 

-9 

-17 


7 


s 


9 


- 


-62 

-76 

-90 

-104 


-63 

-77 

-91 

-105 


-64 

-78 

-92 

-106 


-67 

-81 

-95 

-109 


4 


5 


6 


9 


-59 

-73 

-87 

-101 


-60 

-74 

-88 

-102 


-61 

-75 

-89 

-103 


-66 

-80 

-94 

-108 


I 


2 


3 




Ein- 
gabe 


-56 

-70 
-84 


-57 

-71 
-85 
-99 


-58 

-72 

-86 

-100 






-68 





. 


-82 

-96 

-110 





B7 
BE 


85 


B % 


'•, 


1 




»\ 


'•. 


^ 


,1 . 


, - 1 


HI IS 

B4 B3 B2 B! 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














N Uo 


16 


S P 

32 




48 


§ 

64 


P 

80 


\ 
96 


p 

112 











1 


SH, 


Dl 

17 


I 

33 


1 

49 


A 

65 


Q., 


a 

97 


q 

113 








1 





Sv 

_/X 2 


D 2 

18 


ii 

34 


2 

50 


B 

66 


R 

82 


h 

98 


r 

114 








1 


1 


EX 

3 


D3 

19 


# 
35 


3 

57 


c 

67 


s 

83 


c 

99 


s 

775 





1 








ET 

4 


D 4 

20 


$ 

36 


4 

52 


D 

68 


T 

84 


d 

100 


t 

176 





1 





1 


eq 

5 


NK 

21 


% 
37 


5 

53 


E 

69 


u 

85 


e 

101 


u 

177 





1 


1 





6 


s Y 

22 


& 

38 


6 

54 


F 

70 


V 

86 


f 

102 


V 

118 





1 


1 


1 


BL 

7 


eb 

23 


/ 

39 


7 

55 


G 

71 


w 

87 


g 

103 


w 

719 


1 


0|0 





B s 8 


C N 2 4 


( 

40 


8 

56 


H 

72 


X 

88 


h 

104 


X 

720 


1 


j 


1 


H T 9 


E M, 5 


) 

41 


9 

57 


I 

73 


Y 

89 


i 

105 


y 

727 


1 


0|1 \<2 


LF 

10 


SB 

26 
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42 


58 


J 

74 


z 

90 


j 

106 


z 

722 


110 1 |l 


Vt 

77 


EC 

27 


+ 
43 


59 


K 

75 


A 

91 


k 

107 


a 

723 


1 | 1 [0 10 


FF 

12 


FS 

28 


44 


< 

60 


L 

76 




92 


1 

108 


6 

124 


1 : 1|0 1 


Cr 

13 


29 


45 


61 


M 

77 


u 

93 


m 

109 


ij 

725 


1 1 |1 





so 

14 


Rs 

30 


46 


> 

62 


N 

78; 


A 
94 


n 

110 


126 


ih|i 


1 


si 

15 


us 

31 


/ 

47 


? 

63 


•; 
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~ 95 




m 


dt 
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Figure A-1 2, German Character Set Code Chart 
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CODE CHARTS & KEYBOARD MACROS 
SUPPLEMENTARY 



SUPPLEMENTARY CHARACTER SET 





B7 B6 


B5 


'.. 


*'i 


1 




B ', 


'•• 


'■i 


'<» 


'', 


BITS 

B4 B3 B2 Bl 


CONTROL 


FIGURES 


UPPERCASE 


LOWERCASE 














_H!Lj 


D L« 


S P 

32 



48 


64 


N 

80 


♦- 




772 











1 


IJHJ 


°1, 


A 

33 


1 

49 


(P 

65 


n 

87 


I 




773 








1 





s x, 


D 2 

18 


a 

34 


2 

50 


I 

1 66 


6 

82 


Ht 

1 98 




774 








1 


1 


Ex 

3 


D3 

79 


O 

A 

35 


3 

57 


t 

67 


i 

83 


F F 99 




775 





1 








IJLl 


D 4 

20 


O 

a 

36 


4 
52 


□ 

68 


a 

84 


C R,oo 




776 





1 





1 


E Q S 


27 


/E 
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5 

53 


■ 
69 


o 

85 


707 


- 


777 





1 


1 
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6 
54 


• 

70 


T 

86 


O 
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778 
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1 


1 
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EB 

23 
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A 

77 
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\K 


24 
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5 

72 


88 
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704 




720 










1 


H T 8 
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e 

47 


9 

57 


X 

73 


E 

89 


705 


727 







1 





L F,» 


SB 

26 


e 

42 


u 

58 


74 


Q 

90 


J 


7 06 


722 







1 


1 


n^ 


EC 

27 




43 


59 


L 

75 


r 9 7 


1 


707 


723 




1 








F F, 


28 




44 


<0 

60 


r 

76 


L 


_c 


708 


724 




1 





1 


Cr 

73 


29 




45 


n 

67 


_l 
77 


93 


T 


7 09 


£ 

125 




1 


1 





so 

74 


30 


u 

46 


§ 

62 


78 


94 




770 


• 
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1 


1 


1 


si 

75 


us 

37 


u 

47 
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63 


OO 

79 


r 
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Figure A-13. Supplementary Character Set Code Chart. 
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CODE CHARTS & KEYBOARD MACROS 
RULINGS 



RULINGS CHARACTER SET 





E 
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B 
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'•. 
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Figure A-14. Rulings Character Set Code Chart. 
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Appendix B 
ERROR CODES 



INTRODUCTION 

Each error that the terminal detects has an error code and a 
severity level. 

When the terminal detects an error, it stores the error in a 
iimited-size queue for later retrieval by the REPORT 
ERRORS command. 

If the error's severity level is greater than or equal to the 
current error level, the terminal displays a message for the 
operator. When the terminal is shipped from the factory, its 
error threshold is set to 2; thus the only errors displayed are 
those with a severity level of 2 or 3. The error threshold can 
be changed with the SET ERROR THRESHOLD command 
(ERROR LEVEL in Setup syntax). The error threshold is not 
remembered when the terminal is turned off. 



ERROR CODES 

The error codes are composed according to the following 
scheme: 

• Each error code consists of four characters. 

• in most error codes the first two characters are the 
opcode, an abbreviated code that identifies the 
command that caused the error. 

• The third character is a digit. Digits from 1 to 9 name 
the parameter with which the error is associated; a 
indicates that the error is associated with the command 
as a whole. 

• The fourth character of the error code is also a digit: 

— Indicates an existence problem. The object referred 

to does not exist when it should, or it does exist 
when it shouldn't. 

1 — Indicates an invalid value. 

2 — Indicates an out-of -memory problem. 

3 — Indicates a context problem. The command is 

valid, but cannot be executed at this time. 



For example, consider the MP1 error code. Here "MP" 
refers to the SELECT FILL PATTERN command, which has 
the following syntax: 

E cMP fill-pattern-number 

The "1 " refers to the first (and only) parameter of that com- 
mand, which is the fill pattern number. The "0" indicates an 
existence problem; the fill pattern does not exist. 

SEVERITY LEVELS 

There are four error severity levels: 

» Level 0. Errors of severity Level are minor errors. The 
corresponding message begins with, "Terminal issues 
message " 

• Level 1 . Level 1 errors are warnings. The corresponding 

message begins with, "Terminal issues warning " 

Typically these warnings occur when the command is 
inappropriate or not recognized. 

• Level 2. Level 2 errors result from invalid commands. 
The corresponding message begins with, "Terminal 

detects error " For instance, a parameter may be 

outside the specified range. 

• Level 3. Level 3 errors occur when the command is valid, 
but the terminal cannot execute the command. The 
corresponding message begins with, "Terminal system 
error . . . ." For instance, there may be insufficient 
memory to hold all the information being entered. 
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ERROR CODES 

The rest of this appendix lists each error code alphabetically 
with its severity level and an explanation of the cause. 

1011 (Level 2). Invalid device-function code. (See the 
description of the ENABLE GIN command for a table of 
device-function codes.) 

IA11 (Level 2). Invalid aperture-width (must range from 
to 4095). 

IC13 (Level 2). Graphic input has already been enabled for 
the specified device-function-code. 

IC20 (Level 2). Segment does not exist, or is currently being 
defined. 

IC21 (Level 2). Invalid segment-number (must range from 
to 32767). 

IE00 (Level 2). The cursor segment for the specified device- 
function-code does not exist. (It has been deleted after the 
SET GIN CURSOR command which assigned it to that 
device-function-code.) 

IE03 (Level 2). Command is invalid at this time. (The seg- 
ment being used as the cursor for the specified device- 
function-code is a segment which is currently being 
defined.) 

IE10 (Level 2). The specified GIN device is not installed in 
the terminal. 

IE13 (Level 2). The specified GIN device is already enabled. 

IE21 (Level 2). Invalid number-of GIN -events. (Must range 
from to 65535.) 

IF10 (Level 2). Stroke filtering is not valid for the specified 
device- function-code. (Only allowed for stroke function.) 

IF21 (Level 2). Invalid distance-filter (range is to 32767). 

IF31 (Level 2). Invalid time-filter (range is to 32767). 

IG10 (Level 2). Gridding does not apply to the specified 
device-function-code. (Gridding is not allowed for the stroke 
function.) 



IG21 (Level 2). Invalid x-grid-spacing. Must be in range 
to 4095. 

IG31 (Level 2). Invalid y-grid-spacing. Must be in range 
through 4095. 

1110 (Level 2). Inking does not apply to the specified device- 
function-code. (Inking is not allowed for the pick function.) 

1121 (Level 2). Invalid inking mode (must be 0, 1 or 2). 

IL1 1 (Level 2). Invalid max-line-length. (Must range from 
to 65535.) 

1 1 vi i i (i_evei £.). iiiVcwu t^yjivi-jiequancy setiniy (niusi uts u 
or1). 

IP10 (Level 2). The specified GIN device is not installed in 
the terminal. 

IP13 (Level 2). The device-function-code names a device 
which has already been enabled for a different graphic input 
function. 

IR10 (Level 2). Rubberbanding does not apply to the speci- 
fied device-function-code. (Rubberbanding is only allowed 
for the locator function. It is not allowed for the pick and 
stroke functions.) 

IR21 (Level 2). Invalid rubberbanding mode (must be 0, 1 , 
or 2). 

IS21 (Level 2). Invalid sig-char. (Must range from to 1 27). 

IS31 (Level 2). Invalid term-sig-char. (Must range from 
to 127.) 

IV21 (Level 2). Invalid window-specifier (range is -1 to 64). 

IV31 (Level 2). Invalid first-corner (X or Y out of range 
to 4095). 

IV41 (Level 2). Invalid second-corner (X or Y out of range 
to 4095, or area is of zero width or height). 

IW1 1 (Level 2). Invalid lower-left-corner (X or Y out of range 
through 4095). 

IW21 (Level 2). Invalid - upper-right corner (X or Y out of 
range through 4095). 
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1X10 (Level 2). Invalid operation for define-f unction (see 
ENABLE GIN command). 

1X21 (Level 2). Invalid start-point (x and y must be in the 
range through 4095. 

JC1 1 (Level 2). Invalid source device specifier (must be 
"HO:"). 

JC12 (Level 3). Out of memory while parsing the first 
parameter. 

JC21 (Level 2). Invalid separator string (must be a N u 
character or the string "TO"). 

JC22 (Level 3). Out of memory while parsing the second 
parameter. 

JC31 (Level 2). Invalid destination device specifier. Must be 
the string "HC:", "P0:", or "Pi:"; or port is busy. 

JC32 (Level 3). Out of memory while parsing the third 
parameter. 

JC39 (Level 2). Hardcopy device not ready. Check the hard- 
copy unit. 

KA03 (Level 1). Context problem, cannot disable dialog 
area when in ANSI mode. 

KA1 1 (Level 2). Parameter out of range (must be or 1). 

KB1 2 (Level 2). Out of memory while parsing the array. 

KD1 1 (Level 2). Invalid macro number (must be in range 
-150 to 32767). 

KD21 (Level 2). Invalid character code in the ASCII- 
decimal-equivalents parameter. (Character codes must be 
in the range from to 1 27. The array count must be in the 
range from to 65535.) 

KD22 (Level 3). Insufficient memory to define macro. 

KE11 (Level 2). Invalid echo mode (must be or 1). 

KF1 1 (Level 2). Invalid LFCR mode (must be or 1 ). 

KH1 1 (Level 2). Invalid hardcopy code (must be 0, 1 , or 2). 



KM 1 (Level 2). Invalid ignore-deletes mode (must be or 1). 

KL1 1 (Level 2). Invalid keyboard-lock mode (must be 
0or1). 

K011 (Level 2). Invalid macro number. 

K021 (Level 2). Invalid character-code in the ADE parame- 
ter (character codes must be in teh range through 1 27; the 
array count must be in the range through 65535). 

K022 'Level 3V Insufficient memorvto define macro. 

KR11 (Level 2). Invalid "CR-implies-LF" mode (must be 
0or1). 

KS11 (Level 2). Invalid parameter (must be or 1) 

KT1 1 (Level 2). Invalid error threshold (must be in range 
from to 4). 

KU02 (Level 2). Nonvolatile memory hardware error. 

KW1 1 (Level 2). Invalid mode (must be or 1 ). 

KX01 (Level 2). The maximum nesting depth for the 
EXPAND MACRO command has been exceeded. The 
nesting depth should not exceed five. Greater nesting 
depths may result in KX01 errors. 

KX02 (Level 3). Out of memory while performing EXPAND 
MACRO command. 

KX11 (Level 2). Invalid macro identifier (must be in the 
range from -150 to 32767). 

KY1 1 (Level 2). Invalid key-execute-delimiter code (must be 
in range to 127). 

KZ1 1 (Level 2). Invalid character-delete character (must 
range from to 127). 

KZ21 (Level 2). Invalid line-delete character (must range 
from to 127). 

KZ31 (Level 2). Invalid take-literally character (must range 
from to 127). 

LB03 (Level 0). Dialog parameters modified. 
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LB11 (Level 2). Invalid number-of-lines parameter (must be 
in the range from 2 to 49). 

LE02 (Level 3). Out of memory while performing END 
PANEL command. 

LE03 (Level 1). No panel is currently being defined. 

LI11 (Level 2). Invalid character index (must be in the range 
from to 65535). 

LI21 (Level 2). Invalid character background index (must be 
in the range from to 65535). 

LI31 (Level 2), Invalid dialog area win? index 'must be in 
the range from to 65535). 

LK02 (Level 3). Out of memory while performing INCLUDE 
COPY OF SEGMENT. 

LK1 (Level 2). Segment does not exist. 

LK1 1 (Level 2). Invalid segment-number (must be -3, -1 , or 
in the range 1 through 32767). 

LK13 (Level 2). The segment specified is currently being 
defined. 

LL1 1 (Level 2). Invalid parameter (must be in the range of 2 
through 30. 

LM1 1 (Level 2). Invalid writing mode (must be or 1). 

LP03 (Level 2). Alphatext is not allowed within a PANEL 
DEFINITION. When the terminal is in alpha mode, be sure 
the dialog area is enabled; otherwise, the terminal attempts 
to read alphatext as xy parameters. 

LP21 (Level 2). Invalid "draw boundary" mode (must be 
or1). 

LT03 (Level 2). Command is invalid at this time. Graphtext 
is not allowed within a PANEL DEFINITION. When this error 
is detected, the panel being defined is closed, as if an END 
PANEL command were received. 

LT11 (Level 2). Invalid graphtext string. Invalid array count 
(must be in range from to 32767), or invalid character in 
the array (must be in the range from SP to ( - ) — decimal 
equivalents from 32 to 126). 



LT12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the string parameter). 

LV1 1 (Level 2). Invalid dialog area visibility mode (must be 
0or1). 

MA1 1 (Level 2). Invalid slant-angle (must range from 
-32767.0 to +32767.0). 

MB11 (Level 2). Invalid text-background-index (mus\ range 
from -2 to 32767). 

MB21 (Level 2). Invalid dash-gap-index (must be in range 
from -2 to 32767). 

MC1 1 (Level 2). Invalid value in parameter 1 (must be in 
range 1 through 4095). 

MC21 (Level 2). Invalid value in parameter 2 (must be in 
range 1 through 4095). 

MC31 (Level 2). Invalid value in parameter 3 (must be in 
range 1 through 4095). 

MF10 (Level 2). Font is not defined. 

MF11 (Level 2). \nva\\d font-number (must range from 
to 32767). 

MG1 1 (Level 2). Invalid parameter (must be or 1 ). 

MI03 (Level 2). Command is invalid at this time (no segment 
is currently being defined). 

MI11 (Level 2). Invalid pick-number (must range from 
to 32767). 

ML1 1 (Level 2). Invalid line index (must be in the range from 
to 32767). 

MM1 1 (level 2). Invalid marker type (must be in the range 
from to 10) 

MN1 1 (Level 2). Invalid rotation angle (must be either 0, 90, 
180, or 270). 

MP10 (Level 2). Specified fill pattern does not exist. 

MP1 1 (Level 2). Invalid fill pattern number (must be in the 
range from -32768 to 1 6 or 50 to 1 74). 
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MQ1 1 (Level 2). Invalid precision mode (must be 1 or 2). 

MRU (Level 2). Invalid rotation angle (must be in the range 
-32767.0 to 32767.0). 

MT11 (Level 2). Invalid text index (must be in the range 
from to 65535). 



NR1 1 (Level 2). Invalid transmit (terminal-to-host) data rate 
(must be either 1, 75, 110, 134, 150, 300, 600, 1200, 2400, 
4800,9600, or 18200). 

NR21 (Level 2). Invalid receive (host-to-terminal) data rate 
(must be either 0, 1 , 75, 1 1 0, 1 34, 1 50, 300, 600, 1 200, 
2400, 4800, 9600, or 19200). 



MV11 (Level 2). Invalid line style (must be in the range from 
0to7). 



NS11 (Level 2). Invalid prompt-string parameter (must be 
an array of up to 10 ASCII characters). 



NB1 1 (Level 2). Invalid number of stop bits (must be 1 or 2). 

NC1 1 (Level 2). Invalid value in parameter 1 . Can be any 
ASCII character except the N u character. 

NC21 (Level 2). Invalid value in parameter 2. Can be any 
ASCII character except the N u character. 

ND1 1 (Level 2). Invalid transmit delay time (must be in the 
range from to 65535 milliseconds). 

NE1 1 (Level 2). Invalid EOF-string (must contain from to 
10 characters, with each character represented by an inte- 
ger in the range from to 1 27). 

NE12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the end-of-file-string parameter). 



NS12 (Level 3). Parameter 1 memory error (out of memory 
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NT1 1 (Level 2). Invalid array count in EOL-string. The array 
must hold from to 2 int parameters. Each int in the array 
must be in the range from to 127. 

NT12 (Level 3). Parameter 1 memory error (out of memory 
while parsing the EOL-string parameter). 

NU1 1 (Level 2). Invalid numeric equivalent of bypass-can- 
cel character (must be in the range from to 255). 

PA00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

PA11 (Level 2). Invalid port-identifier (must be P0: or P1:). 



NF11 (Level 2). Invalid flagging mode (must be in the range 
from to 4). 

NK1 1 (Level 2). Invalid parameter (must be in the range 
from to 65535). 



PA12 (Level 3). Out of memory while parsing the port- 
identifier string. 

PA21 (Level 2). Invalid protocol-identifier (must be PPORT, 
4662, 4662/MP, 4663, or 4681). 



NL1 1 (Level 2). Invalid transmit rate limit (must be in the 
range from 75 to 19200). 

NM11 (Level 2). Invalid prompt mode parameter (must be 0, 
1,or2). 

NP1 1 (Level 2). Invalid parity code (must be in the range 
from to 4). 

NQ02 (Level 3). Out of memory while performing SET 
QUEUE SIZE command. 

NQ1 1 (Level 2). Invalid queue size (must be in the range 
froml to 65535), 



PA22 (Level 3). Out of memory while parsing protocol- 
identifier siring. 

PB00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

PB11 (Level 2). Invalid port-name (must be P0: or P1:). 

PB12 (Level 3). Out of memory while parsing the port-name 
string. 

PB21 (Level 2). Invalid number-of-stop-bits (must be 1 or 2). 

PB31 (Level 2). Invalid number-of-data-bits (must be 5, 6, 7, 
or 8). ' 
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PEOO (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

PE1 1 (Level 2). Invalid port-name (must be P0: or P1 :). 

PE12 (Level 3). Out of memory while parsing the port-name 
string. 

PE21 (Level 2). Invalid EOF-string (the integer array must 
have from to 1 elements, and each integer in the array 
must be in the range from to 1 27.) 

PE22 (Level 3). Out of memory while parsing the EOF- 
string integer array. 

PF11 (Level 2), Invalid port-name (must be P0: or PI:) 

PF12 (Level 3). Out of memory while parsing the port-name 
string. 

PF21 (Level 2). Invalid flagging-mode (must be 0, 1 or 2). 

PF31 (Level 2). Invalid GO character (must be in range 
to 127). 

PF41 (Level 2). Invalid STOP character (must be in range 
to 127; if non-zero, must be different from the GO character). 

PI00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

PI1 1 (Level 2). Invalid port-name (must be P0: or P1 :). 

PI12 (Level 2). Out of memory while parsing the port-name 
string. 

PI21 (Level 2). Invalid index (must be in the range -1 
through 255). 

PI31 (Level 2). Invalid pen-number (must be in the range 
through 255). 

PL00 (Level 0). Unrecognized command (terminal is not a 
4107 or 4109). 

PL11 (Level 2). Invalid separator. (Must be the empty string 
or TO.) 

PL12 (Level 3). Out of memory while parsing the separator- 
string . 



PL21 (Level 2). Invalid output-specifier (must be P0: or P1 :), 

or port is busy. 

PL22 (Level 3). Out of memory while parsing the output- 
specifier. 

PL23 (Level 2). Parameter 2 context error (invalid destina- 
tion device, or device is busy.) 

PP1 1 (Level 2). Invalid port-name (must be P0: or P1 :), or 

port is busy. 

PP12 (Level 3). Out of memory while parsing the port-name 
string. 

PP21 (Level 2), Invalid parity-mode (must be in ran^e 
to 4). V 

PQ00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

PQ11 (Level 2). lnvalid/?or?-«a/72e(mustbePO:orP1:). 

PQ12 (Level 3). Out of memory while parsing the port-name 
string. 

PR00 (Level 0). Unrecognized command (terminal is not a 
4107 or 4109). 

PR1 1 (Level 2). Invalid port-name (must be P0: or P1 :). 

PR12 (Level 3). Out of memory while parsing the port-name 
string. 

PR21 (Level 2). Invalid baud-rate (must be 75, 1 1 0, 1 34, 
150, 300, 600, 1200, 1800, 2000, 2400, 4800, or 9600). 

QA1 1 (Level 2). Invalid copy size (must be or 1). 

QD11 (Level 2). Invalid copier value. 

QL11 (Level 2). Invalid page number. 

QL21 (Level 2). Invalid page origin. 

QL31 (Level 2). Invalid f ^-interpretation \ 'alue. 

RA10 (Level 2). Surface does not exist (has not been 
defined with SET SURFACE DEFINITIONS command). 
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RA1 1 (Level 2). Invalid surface number (must be in the 
range -1 through 4), 

RA21 (Level 2). Invalid background index (must be in range 
through 65535). 

RA31 (Level 2). Invalid value (must be in range through 
65535). 

RCOO (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 03). 



RI11 (Level 2). Invalid surface-numbers-and-visibilities array 
(each surface number must be in the range 1 through 4; 
each visibility code must be 0, 1 , or 2). 

RI1 2 (Level 3). Out of memory while parsing the surface- 
numbers-and-visibilities array. 

RJ1 1 (Level 2). Invalid locking-mode (must be or 1 ). 

RK1 (Level 1). The designated view does not exist (has not 
been defined with a SELECT VIEW command). 



-1 through 64). 

RD00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

RD10 'Level 2). Occupied undefined surface. (This com- 
mand would have resulted in a dialog area viewport, pixel 
viewport, or numbered graphic viewport residing on an 
undefined surface.) 

RD1 1 (Level 2). Invalid surface-defs array (there must be 
one to four integers in each array and each integer must be 
in the range through 4). 

RD12 (Level 3). Out of memory while parsing the surface- 
defs array. 

RE00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

RE11 (Level 2). Invalid border-visibility-mode parameter 

<m\ ict hofl 1 r\rO\ 
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RF00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

RF11 (Level 2). Invalid./ratf?-/eve/(must be in the range 
through 32767). 

RI00 (Level 0): Unrecognized command (terminal is not a 
41 07 or 41 09). 

RI10 (Level 2). A surface in surface-numbers-and-visibilities 
does not exist (has not been defined with a SET SURFACE 
DEFINITIONS command). 
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-1 through 64). 

RL1 1 (Level 2). Invalid runcode-array (the array count must 
range from to 65535, and each integer in the array must 
also range from to 65535). 

RL1 2 (Level 3). Out of memory while parsing the parameter, 
or while executing the command. 

RN00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

RN10 (Level 2). Surface does not exist (has not been 
defined with a SET SURFACE DEFINITIONS command). 

RN11 (Level 2). Invalid priorities array (there must be an 
even number of integers in the array, and each integer must 
be in the range 1 through 4). 

RN12 (Level 3). Out of memory while parsing the priorities 
array. 

RP1 1 (Level 2). Invalid number of pixels (must be in the 
range through 65535). 

RP21 (Level 2). There are too many or too few pixels in the 
code array. 

RP22 (Level 3). Parameter 2 memory error (out of memory 
while parsing the character-array parameter. 

RQ00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

RQ11 (Level 2). Invalid view-numbers array (each view 
number must range from -2 to 64.) 
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RQ12 (Level 3). Out of memory while parsing the view- 
numbers array. 

RR1 1 (Level 2). Invalid lower-left coordinates (x must be in 
the range through 51 1 , and y from through 359). 

RR21 (Level 2). Invalid upper-right coordinates (x must be 
in the range through 51 1 , and y from through 359). 

RR31 (Level 2). Invalid fill-index (must be in range 
through 65535). 

RR1 1 (Level 0). Invalid lower-left coordinates (x value is 
between range of 480 and 51 1). 



RV21 (Level 2). Invalid second-corner (x must be in the 
range through 4095, and y in the range through 3071). 

RX10 (Level 2). The specified destination-surface does not 
exist. 

RX1 1 (Level 2). Invalid destination surface (must be in the 
range -1 through 4). 

RX21 (Level 0). Invalid destination lower-left corner (x must 
be in range through 639 and y in range through 479). 

RX21 (Level 2). Invalid destination lower-left corner (x must 
be in range through 639 and y in range through 511). 



RR21 (Level 0). Invalid upper-right coordinates (x value is 
between range of 480 and 51 1). 

RS11 (Level 2). Invalid lower-left coordinate (x must be in 
the range through 51 1 , and y from through 359). 

RS21 (Level 2). Invalid upper-right coordinate (x must be in 
the range through 51 1 , and y from through 359). 

RS1 1 (Level 0). Invalid lower-left coordinate (x value is 
between range of 480 and 511). 

RS21 (Level 0). Invalid upper-right coordinate (x value is 
between range of 480 and 51 1). 

RU10 (Level 2). Surface does not exist. 

RU1 1 (Level 2). Invalid surface number (must be in the 
range -1 through 4). 

RU21 (Level 2). Invalid ALU mode (must be 0, 7, 1 1 , 1 2, 1 5). 

RU31 (Level 2). Invalid bits-per-pixel (must be 0, 1 , 2, 3, 4, 
or 6). 

RV00 (Level 0). Unrecognized command (terminal is not a 
4107 or 4109.) 

RV01 (Level 2). Invalid viewport size (the viewport must not 
be more than 8 times larger than the current window). 

RV1 1 (Level 2). Invalid/iref-co/Tze/- (x must be in the range 
through 4095, and y in the range through 3071 ). 



RX31 (Level 0). Invalid first source-corner (x must be in 
range through 639 and y in range through 479). 

RX31 (Level 2). Invalid first source-corner (x must be in 
range through 639 and y in range through 51 1). 

RX41 (Level 0). Invalid second source-corner (x must be in 
range through 639 and y in range through 479). 

RX41 (Level 2). Invalid second source-corner(x must be in 
range through 639 and y in range through 511). 

SA03 (Level 2). Command invalid at this time; the specified 
segment is currently being defined. 

SA10 (Level 2). Segment does not exist. 

SA1 1 (Level 2). Invalid segment-number (must be in the 
range -3 to -1 , or 1 to 32767.) 

SA21 (Level 2). Invalid removal-array. (Each class number 
must be -1 or from 1 to 64). 

SA22 (Level 3). Out of memory while parsing the removal- 
array. 

SA31 (Level 2). Invalid addition-array (each class number 
must be -1 or from 1 to 64). 

SA32 (Level 3). Out of memory while parsing the addition- 
array. 

SB00 (Level 2). The indicated segment already exists. 
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SB01 (Level 2). Invalid for next lower segment number 

SB02 (Level 3). Not enough memory to begin segment, or 
out of memory while ending segment. 

SB03 (Level 2). Context error; command is invalid at this 
time. No segment is currently being defined, or a graphtext 
character is currently being defined. 

SC02 (Level 3). Out of memory while performing command. 

SC03 (Level 1). Invalid at this time; no segment is currently 
being defined. 

SD03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined.) 

SD1 (Level 2). Segment does not exist. 

SD1 1 (Level 2). Invalid segment-number (must range from 
-3to-1,or1 to 32767). 

SD21 (Level 2). Invalid detectability (must be or 1 ). 

SE02 (Level 3). Not enough memory to begin segment, or 
out of memory while ending segment. 

SE03 (Level 2). Command is invalid at this time (a graphtext 
character or a panel is currently being defined without a 
segment being defined). 

SE10 (Level 2). Segment already exists. 

SE11 (Level 2). Invalid segment-number (must be in the 
range 1 through 32767). 

SG02 (Level 3). Out of memory while defining font grid. 

SG10 (Level 2). Font already exists. 

SG11 (Level 2). \nva\\d font-number (must range from 
to 32767). 

SG21 (Level 2). Invalid grid-width (must range from 1 
to 4095.) 

SG31 (Level 2). Invalid grid-height (must range from 1 
to 4095.) 



SH03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined.) 

SH10 (Level 2). Segment does not exist. 

SH1 1 (Level 2). Invalid segment-number (must range from 
-3 to -1 , or from 1 to 32767). 

SH21 (Level 2). Invalid highlighting (must be or 1). 

5102 (Level 3). Out of memory while transforming segment. 

5103 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined.) 

5110 (Level 2). Segment does not exist. 

511 1 (Level 2). Invalid segment-number (must range from -3 
to -1, onto 32767). 

SI21 (Level 2). Invalid x-scale-factor (must range from 
-32767.0 to 32767.0.) 

SI31 (Level 2). invalid y-scale-factor (must range from 
-32767.0 to 32767.0.) 

SI41 (Level 2). Invalid rotation-angle (must range from 
-32767.0 to 32767.0.) 

SK02 (Level 3). Out of memory while attempting to delete a 
segment. 

SK10 (Level 1). Segment does not exist. 

SK1 1 (Level 2). Invalid segment-number (must be -3, -1 , or 
in the range 1 to 32767). 

SL11 (Level 2). Invalid inclusion-set (class numbers must be 
-1, or from 1 to 64). 

SL12 (Level 3). Out of memory while parsing the inclusion- 
set array. 

SL21 (Level 2). Invalid exclusion-set (class numbers must 
be -1, or from 1 to 64). 

SL22 (Level 3). Out of memory while parsing the exclusion- 
set array. 
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SM03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined). 

SM10 (Level 2). Segment does not exist. 

SM1 1 (Level 2). Invalid segment-number (must range from 
-3 through 32767). 

SM21 (Level 2). Invalid writing-mode (must be or 1). 

SNOO (Level 2). The indicated segment already exists. 

SN01 (Level 2). Invalid for next higher segment number 
(current segment ID is 32767). 

SN02 (Level 3). Out of memory while ending segment. 

SN03 (Level 2). No segment is currently being defined, or a 
graphtext character is currently being defined. 

5002 (Level 3). Out of memory while defining segment. 

5003 (Level 2). Another segment, or a panel is currently 
being defined. 

5010 (Level 2). Segment already exists. 

5011 (Level 2). Invalid segment-number (must range from 
1 to 32767). 

SQ10 (Level 2). Segment does not exist. 

SQ11 (Level 2). Invalid segment-number (must range from 
-3 to 32767). 

SQ21 (Level 2). Invalid array of codes. (Must include only 
the uppercase letters A, D, H, I, M, R S, V, and X. Also, the 
array count must be in the range from to 65535.) 

SQ22 (Level 3). Out of memory while parsing the 
parameter. 

SR03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined). 

SR10 (Level 2). Segment does not exist. 

SR1 1 (Level 2). Invalid old-segment-number (must range 
from 1 to 32767). 



SR20 (Level 2). Invalid new-segment-number (a segment 
with that number already exists). 

SR21 (Level 2). Invalid new-segment-number (must range 
from 1 to 32767). 

SS03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined). 

551 (Level 2). Segment does not exist. 

551 1 (Level 2). Invalid segment-number (must range from 
-3 to -1 , or from 1 to 32767). 

SS21 (Level 2). Invalid priority-number (must range from 
-32768 to 32767). 

ST02 (Level 3). Out of memory while defining graphtext 
character. 

ST03 (Level 2). Command is invalid at this time (a graphtext 
character is currently being defined). 

ST10 (Level 2). The font specified has no grid defined for it. 

ST11 (Level 2). Invalid /o«? number (must be in the range 
through 32767). 

ST20 (Level 2). The character specified has already been 
defined inthis/o«r. 

ST21 (Level 2). Invalid character number (must be in the 
range 32 to 126). 

SU03 (Level 1). Command is invalid at this time (no 
graphtext character is being defined). 

SV02 (Level 3). Out of memory while performing command. 

SV03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined). 

SV10 (Level 2). Segment does not exist. 

SV11 (Level 2). Invalid segment-number (must range from 
-3 to 32767). 

SV21 (Level 2). Invalid visibility (must be or 1). 
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SX02 (Level 3). Out of memory while performing command. 

SX03 (Level 2). Command is invalid at this time (the 
specified segment is currently being defined). 

SX10 (Level 2). Segment does not exist. 

SX1 1 (Level 2). Invalid segment-number (must range from 
-3 to 32767). 

SZ03 (Level 2). Command is invalid at this time (a graphtext 
character is currently being defined). 



TD21 (Level 2). Invalid index value (must be between 
and 65535) 

TF1 1 (Level 2). Invalid color-mixtures array (must be an 
array of quadruples consisting of a color index and the three 
HLS color coordinates). 

TF12 (Level 3). Parameter 2 memory error (out of memory 
while parsing the color-mixtures array). 

TG1 1 (Level 2). Invalid surface number (must be -1 , or in 
the ranae 1 throuah 4). 



SZ10 (Level 1). The specified font does not exist (no grid 
has been defined for that font). 

SZ11 (Level 2). \nva\\d font-number (must range from 
-1 to 32767). 

SZ20 (Level 1). The character specified does not exist in 
this font. 

SZ21 (Level 2). Invalid char-number (must be -1 , or in the 
range 32 to 126). 

TBOO (Level 0). Unrecognized command (terminal is not a 
4107 or 4109). 

TB11 (Level 2). Invalid first-color-coordinate (if in HLS 
mode, must be in the range -32768 through 32767; if in 
RGB or CMY mode, must be in the range through 1 00). 

TB21 (Level 2). Invalid second-color-coordinate (must be in 
the range through 1 00). 

TB31 (Level 2). Invalid third-color-coordinate (must be in 
the range through 100). 

TC1 1 (Level 2). Invalid hue value (must be between -32768 
and 32767) 

TC21 (Level 2). Invalid lightness value (must be between 
and 100) 

TC31 (Level 2). Invalid saturation value (must be between 
and 100) 

TD11 (Level 2). Invalid index value (must be between 
and 65535) 



TG21 (Level 2). Invalid color-mixtures array (must be an 
array of quadruples consisting of a color index and the three 
HLS color coordinates). 

TG22 (Level 3). Parameter 2 memory error (out of memory 
while parsing the color-mixtures array). 

TM00 (Level 0). Unrecognized command (terminal is not a 
41 07 or 41 09). 

TM11 (Level 2). Invalid color-specif ying-mode (must range 
from to 3). 

TM21 (Level 2). Invalid color-overlay-mode (must range 
from to 3). 

TM31 (Level 2). Invalid gray-mode (must be or 1). 

[A1 1 (Level 2). Invalid value (must be in the range of 
to 32767). 

[B1 1 (Level 2). Invalid value (must be in the range of 
to 32767). 

[C1 1 (Level 2). Invalid value (must be in the range of 
to 32767). 

[d 1 (Level 2). Invalid first parameter (must be or omitted). 

[D1 1 (Level 2). Invalid value (must be in the range of 
to 32767). 

[f11 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 
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[f21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 

[g1 1 (Level 2). Invalid value (must be 0, 2 or 3). 

[h01 (Level 2). Invalid mode value (must be either 4, 20, 
<1,?1,?3, ?6,?7,or?8). 

[h10to[h90(Level2). Invalid mode value. 

[h11 to [h91 (Level 2). Invalid parameter syntax. 

[H11 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 

[H21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 

[11 1 (Level 2). Invalid value (must be in the range of 
to 32767). 

[J1 1 (Level 2). Invalid value (must be 0, 1 or 2). 

[K11 (Level 2). Invalid value (must be 0, 1 or 2). 

[101 (Level 2). Invalid mode value (must be either 4, 20, < 1 , 
?1 , ?3, ?6, ?7, or ?8). 

[110 to [I90 (Level 0). Unrecognized mode value (treated as 
a no-op). 

[11 1 to [191 (Level 2). Invalid parameter syntax. 

[L11 (Level 2). Invalid value (must be in the range of to 
32767). 

[m01 (Level 2). Invalid rendition value (must be either 0, 1 , 
4, 5, 7, <, >,or =). 



[M1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[n11 (Level 2). Invalid value for parameter 1 (must be 6). 

[P1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[r1 1 (Level 2). Invalid value for parameter 1 (must be in the 
range of to 32767). 

[r21 (Level 2). Invalid value for parameter 2 (must be in the 
range of to 32767). 

[S1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[T1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[X1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[Z1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

[@1 1 (Level 2). Invalid value (must be in the range of to 
32767). 

%!1 1 (Level 2). Invalid parameter R(must be 0, 1 , or 2). 

#!1 1 (Level 2). Invalid parameter (must be 0). 

s rA1 1 (Level 2). Invalid value (must be to 32767). 

s p@1 1 (Level 2). Invalid value (must be to 32767). 
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Appendix C 



COMMAND SUMMARY 



BEGIN GRAPHTEXT CHARACTER 

BEGIN HIGHER SEGMENT 

BEGIN LOWER SEGMENT 

BEGIN NEW SEGMENT 

BEGIN PANEL BOUNDARY 

BEGIN PIXEL OPERATIONS 

BEGIN SEGMENT 

CANCEL 

CLEAR DIALOG SCROLL 

COPY 

CRLF 

DEFINE MACRO 

DELETE GRAPHTEXT CHARACTER 

DELETE SEGMENT 

DELETE VIEW 

DISABLE GIN 

DRAW 

DRAW MARKER 

ENABLE DIALOG AREA 

ENABLE GIN 

ENABLE 4010 GIN 

END GRAPHTEXT CHARACTER 

END PANEL 

END SEGMENT 

ENTER ALPHA MODE 

ENTER BYPASS MODE 

ENTER MARKER MODE 

ENTER VECTOR MODE 

EXPAND MACRO 

FACTORY 



MACRO STATUS 

MAP INDEX TO PEN 

MOVE 

PAGE 

PIXEL COPY 

PLOT 

PORT ASSIGN 

PROMPT MODE 

RASTER WRITE 

RECTANGLE FILL 

RENAME SEGMENT 
RENEW VIEW 
REPORT ERRORS 
REPORT SYNTAX MODE 
REPORT DEVICE STATUS 
REPORT GIN POINT 
REPORT PORT STATUS 
REPORT SEGMENT STATUS 
REPORT TERMINAL SETTINGS 
REPORT 4010 STATUS 

RESET 

RUNLENGTH WRITE 

SAVE NONVOLATILE PARAMETERS 

SELECT CODE 

SELECT FILL PATTERN 

SELECT HARDCOPY INTERFACE 

SELECT VIEW 

SET ALPHA CURSOR INDICES 

SET ALPHATEXT FONT 

SET BACKGROUND COLOR 



SET DIALOG AREA COLOR MAP 

SET DIALOG HARDCOPY ATTRIBUTES 

SET DIALOG AREA INDEX 

SET DIALOG AREA LINES 

SET DIALOG AREA VISIBILITY 

SET DIALOG AREA WRITING MODE 

SET ECHO 

SET EDIT CHARACTERS 

SET EOF STRING 

SET EOL STRING 

SET EOM CHARACTERS 

SET ERROR THRESHOLD 

SET FIXUP LEVEL 

SET FLAGGING MODE 

SET GIN AREA 

SET GIN CURSOR 

SET GIN CURSOR COLOR 

SET GIN DISPLAY START POINT 

SETGINGRIDDING 

SET GIN INKING 

SET GIN RUBBERBANDING 

SET GIN STROKE FILTERING 

SET GIN WINDOW 

SET GRAPHICS AREA WRITING MODE 

SET GRAPHTEXT FONT 

SET GRAPHTEXT FONT GRID 

SET GRAPHTEXT PRECISION 

SET GRAPHTEXT ROTATION 

SET GRAPHTEXT SIZE 

SET GRAPHTEXT SLANT 



GRAPHIC TEXT 

HARDCOPY 

HELP 

IGNORE DELETES 

INCLUDE COPY OF SEGMENT 

LEARN/NVLEARN 

LFCR 

LOCAL 

LOCK KEYBOARD 

LOCK VIEWING KEYS 



SET BACKGROUND INDICES 

SET BAUD RATES 

SET BORDER VISIBILITY 

SET BREAK TIME 

SET BYPASS CANCEL CHARACTER 

SET CHARACTER PATH 

SET COLOR MODE 

SET COPY SIZE 

SET CURRENT MATCHING CLASS 

SET DIALOG AREA BUFFER SIZE 



SET KEY EXECUTE CHARACTER 

SET LINE INDEX 

SET LINE STYLE 

SET MARKER TYPE 

SET PARITY 

SET PICK APERTURE 

SET PICK ID 

SET PIVOT POINT 

SET PIXEL BEAM POSITION 

SET PIXEL VIEWPORT 
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COMMAND SUMMARY 



SET PORT BAUD RATE 

SET PORT EOF STRING 

SET PORT FLAGGING MODE 

SET PORT PARITY 

SET PORT STOP BITS 

SET PROMPT STRING 

SET QUEUE SIZE 

SET REPORT EOM FREQUENCY 

SET REPORT MAX LINE LENGTH 

SET REPORT SIG CHARACTERS 

SET SEGMENT CLASS 

SET SEGMENT DETECTABILITY 



SET SEGMENT DISPLAY PRIORITY 
SET SEGMENT HIGHLIGHTING 
SET SEGMENT IMAGE TRANSFORM 
SET SEGMENT POSITION 
SET SEGMENT VISIBILITY 
SET SEGMENT WRITING MODE 
SET SNOOPY MODE 
SET STOP BITS 

SET SURFACE COLOR MAP 
SET SURFACE DEFINITIONS 
SET SURFACE PRIORITIES 
SET SURFACE VISIBILITY 



SET TAB STOPS 
SET TEXT INDEX 
SET TRANSMIT DELAY 
SET TRANSMIT RATE LIMIT 
SET VIEW ATTRIBUTES 
SET VIEW DISPLAY CLUSTER 

SET VIEWPORT 

SET WINDOW 

SET 401 4 ALPHATEXT SIZE 

SET 401 4 LINE STYLE 

STATUS 

4010HARDCOPY 
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Appendix D 



EXAMPLES OF INTEGER PARAMETERS 



Table D-1 lists integer parameters between -1049 and +1049. 



Table D-1 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 








-0 


s p 


1 


1 


-1 


i 


2 


2 


-2 


" 


3 


3 


-3 


# 


4 


4 


-4 


$ 


5 


5 


-5 


% 


6 


6 


-6 


& 


7 


7 


-7 


' 


8 


8 


-8 


( 


3 


3 


-3 


\ 

/ 


10 




-10 


* 


-i 1 




_i i 


-i- 


12 


< 


-12 


, 


13 


= 


-13 


- 


14 


> 


-14 




15 


? 


-15 


/ 


16 


A0 


-16 


A s p 


17 


A1 


-17 


A! 


18 


A2 


-18 


A" 


19 


A3 


-19 


A# 


20 


A4 


-20 


A$ 


21 


A5 


-21 


A% 


22 


A6 


-22 


A& 


23 


A7 


-23 


A' 


24 


A8 


-24 


A( 


25 


A9 


-25 


A) 


26 


A: 


-26 


A* 


27 


A; 


-27 


A + 


28 


A< 


-28 


A, 


29 


A= 


-29 


A- 


30 


A> 


-30 


A. 


31 


A? 


-31 


A/ 


32 


BO 


-32 


B s p 


33 


B1 


-33 


B! 


34 


B2 


-34 


B" 


35 


B3 


-35 


b# 


36 


B4 


-36 


B$ 


37 


B5 


-37 


B% 


38 


B6 


-38 


B& 


39 


B7 


-39 


B' 


40 


B8 


-40 


B( 


41 


B9 


-41 


B) 


42 


B: 


-42 


B* 


43 


B; 


-43 


B + 


44 


B< 


-44 


B, 


45 


B= 


-45 


B- 


46 


B> 


-46 


B. 


47 


B? 


-47 


B/ 


48 


CO 


-48 


C s p 


49 


C1 


-49 


C! 



+ lnt* 


Param 


-Int" 


Param 


+ lnf 


Param 


-lnt b 


Param 


50 


C2 


-50 


C" 


100 


F4 


-100 


F$ 


51 


C3 


-51 


C# 


101 


F5 


-101 


F% 


52 


C4 


-52 


C$ 


102 


F6 


-102 


F& 


53 


C5 


-53 


c% 


103 


F7 


-103 


F' 


54 


C6 


-54 


c& 


104 


F8 


-104 


F{ 


55 


C7 


-55 


c 


105 


F9 


-105 


F) 


56 


C8 


-56 


C( 


106 


F: 


-106 


F* 


57 


C9 


-57 


C) 


107 


F; 


-107 


F + 


58 


C: 


-58 


c* 


108 


F< 


-108 


F, 


59 




-59 


c+ 


109 


c = 


-109 


p— 


60 


C< 


-60 


c, 


110 


F> 


-110 


F. 


61 


c= 


-61 


c- 


111 


F? 


— 111 


F/ 


62 


c> 


-62 


c. 


112 


GO 


-112 


G s p 


63 


c? 


-63 


c/ 


113 


G1 


-113 


G! 


64 


DO 


-64 


D S P 


114 


G2 


-114 


G" 


65 


D1 


-65 


Di 


115 


G3 


-115 


G# 


66 


D2 


-66 


D" 


116 


G4 


-116 


G$ 


67 


D3 


-67 


D# 


117 


G5 


-117 


G% 


68 


D4 


-68 


D$ 


118 


G6 


-118 


G& 


69 


D5 


-69 


D% 


119 


G7 


-119 


G' 


70 


D6 


-70 


D& 


120 


G8 


-120 


G( 


71 


D7 


-71 


D' 


121 


G9 


-121 


G) 


72 


D8 


-72 


D( 


122 


G: 


-122 


G* 


73 


D9 


-73 


D) 


123 


G; 


-123 


G+ 


74 


D: 


-74 


D* 


124 


G< 


-124 


G, 


75 


D; 


-75 


D + 


125 


G= 


-125 


G- 


76 


D< 


-76 


D, 


126 


G> 


-126 


G. 


77 


D = 


-77 


D- 


127 


G? 


-127 


G/ 


78 


D> 


-78 


D. 


128 


HO 


-128 


H S P 


79 


D? 


-79 


D/ 


129 


H1 


-129 


H! 


80 


EO 


-80 


E s p 


130 


H2 


-130 


H" 


81 


E1 


-81 


E! 


131 


H3 


-131 


H# 


82 


E2 


-82 


E" 


132 


H4 


-132 


H$ 


83 


E3 


-83 


e# 


133 


H5 


-133 


H% 


84 


E4 


-84 


e$ 


134 


H6 


-134 


H& 


85 


E5 


-85 


E% 


135 


H7 


-135 


H' 


86 


E6 


-86 


E& 


136 


H8 


-136 


H( 


87 


E7 


-87 


E' 


137 


H9 


-137 


H) 


88 


E8 


-88 


E( 


138 


H: 


-138 


H* 


89 


E9 


-89 


E) 


139 


H; 


-139 


H + 


90 


E: 


-90 


E* 


140 


H< 


-140 


H, 


91 


E; 


-91 


E + 


141 


H = 


-141 


H- 


92 


E< 


-92 


E, 


142 


H> 


-142 


H. 


93 


E = 


-93 


E- 


143 


H? 


-143 


HI 


94 


E> 


-94 


E. 


144 


10 


-144 


l s P 


95 


E? 


-95 


E/ 


145 


11 


-145 


1! 


96 


FO 


-96 


F s p 


146 


12 


-146 


1" 


97 


F1 


-97 


F! 


147 


13 


-147 


l# 


98 


F2 


-98 


F" 


148 


14 


-148 


1$ 


99 


F3 


-99 


F# 


149 


15 


-149 


1% 



Positive integer 
Negative integer 



For integers ± 144 through ± 159, the first char- 
acter of the parameter is an uppercase I (A DE 73). 
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INTEGER PARAMETERS 



+ lnt" 


Pararn 


-lnt b 


Param 


150 


16 


-150 


l& 


151 


17 


-151 


I' 


152 


18 


-152 


K 


153 


19 


-153 


1) 


154 


1: 


-154 


1* 


155 


I; 


-155 


1 + 


156 


l< 


-156 


1, 


157 


1 = 


-157 


1- 


158 


l> 


-158 


1. 


159 


1? 


-159 


1/ 


160 


JO 


-160 


J s p 


161 


J1 


-161 


J! 


162 


J2 


-162 


J" 


163 


J3 


-163 


J# 


164 


J4 


-164 


JS 


165 


J5 


-165 


J% 


166 


J6 


-166 


J& 


167 


J7 


-167 


J' 


168 


J8 


-168 


J( 


169 


J9 


-169 


J) 


170 


J: 


-170 


J* 


171 


J; 


-171 


J + 


172 


J< 


-172 


J, 


173 


J = 


-173 


J- 


174 


J> 


-174 


J. 


175 


J? 


-175 


J/ 


176 


KO 


-176 


K s p 


177 


K1 


-177 


K! 


178 


K2 


-178 


K" 


179 


K3 


-179 


K# 


180 


K4 


-180 


KS 


181 


K5 


-181 


K% 


182 


K6 


-182 


K& 


183 


K7 


-183 


K' 


184 


K8 


-184 


K( 


185 


K9 


-185 


K) 


186 


K: 


-186 


K* 


187 


K; 


-187 


K + 


188 


K< 


-188 


K, 


189 


K = 


-189 


K- 


190 


K> 


-190 


K. 


191 


K? 


-191 


K/ 


192 


LO 


-192 


L S P 


193 


L1 


-193 


L! 


194 


L2 


-194 


L" 


195 


L3 


-195 


L# 


196 


L4 


-196 


L$ 


197 


L5 


-197 


L% 


198 


L6 


-198 


L& 


199 


L7 


-199 


L' 
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INTEGER PARAMETERS 


+ lnt 


Param 


-Int" 


Param 


200 


L8 


-200 


L( 


201 


L9 


-201 


L) 


202 


L: 


-202 


L* 


203 


L; 


-203 


L+ 


204 


L< 


-204 


L, 


205 


L = 


-205 


L- 


206 


L> 


-206 


L. 


207 


L? 


-207 


L/ 


208 


MO 


-208 


M s p 


209 


M1 


-209 


M! 


210 


M2 


-210 


M" 


211 


M3 


-211 


M# 


212 


M4 


-212 


MS 


213 


M5 


-213 


M% 


214 


M6 


-214 


M& 


215 


M7 


-215 


M' 


216 


M8 


-216 


M( 


217 


M9 


-217 


M) 


218 


M: 


-218 


M* 


219 


M; 


-219 


M + 


220 


M< 


-220 


M, 


221 


M = 


-221 


M- 


222 


M> 


-222 


M. 


223 


M? 


-223 


Mi 


224 


NO 


-224 


N S P 


225 


N1 


-225 


N! 


226 


N2 


-226 


N" 


227 


N3 


-227 


N# 


228 


N4 


-228 


N$ 


229 


N5 


-229 


N% 


230 


N6 


-230 


N& 


231 


N7 


-231 


N' 


232 


N8 


-232 


N( 


233 


N9 


-233 


N) 


234 


N: 


-234 


N* 


235 


N; 


-235 


N + 


236 


N< 


-236 


N, 


237 


N = 


-237 


N- 


238 


N> 


-238 


N. 


239 


N? 


-239 


N/ 


240 


00 


-240 


O s P 


241 


01 


-241 


0! 


242 


02 


-242 


0" 


243 


03 


-243 


0# 


244 


04 


-244 


0$ 


245 


05 


-245 


0% 


246 


06 


-246 


0& 


247 


07 


-247 


0' 


248 


08 


-248 


0( 


249 


09 


-249 


0) 



+ Inf Param 



-Inf 



Param 



281 


Q9 


-281 


Q) 


282 


Q: 


-282 


Q* 


283 


Q; 


-283 


Q + 


284 


Q< 


-284 


Q, 


285 


Q= 


-285 


Q- 


286 


Q> 


-286 


Q. 


287 


Q? 


-287 


0/ 


288 


RO 


-288 


R S P 


289 


R1 


-289 


R! 


290 


R2 


-290 


R" 


291 


R3 


-291 


R# 


292 


R4 


-292 


R$ 


293 


R5 


-293 


R% 


294 


R6 


-294 


R& 


295 


R7 


-295 


R' 


296 


R8 


-296 


R( 


297 


R9 


-297 


R) 


298 


R: 


-298 


R* 


299 


R; 


-299 


R + 



Positive integer 

b 

Negative integer 

For integers ± 144 through ± 159, the first char- 
acter of the parameter is an uppercase I (ADE 73). 
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INTEGER PARAMETERS 



+ lnf 


Param 


-lnt b 


Param 


300 


R< 


-300 


R, 


301 


R = 


-301 


R- 


302 


R> 


-302 


R. 


303 


R? 


-303 


R/ 


304 


SO 


-304 


S s p 


305 


S1 


-305 


S! 


306 


S2 


-306 


S" 


307 


S3 


-307 


s# 


308 


S4 


-308 


ss 


309 


S5 


-309 


S% 


310 


S6 


-310 


s& 


311 


S7 


-311 


S' 


312 


S8 


-312 


S( 


313 


S9 


-313 


S) 


314 


S: 


-314 


S* 


315 


S; 


-315 


s+ 


316 


S< 


-316 


s, 


317 


S = 


-317 


S- 


318 


S> 


-318 


S. 


319 


S? 


-319 


s/ 


320 


TO 


-320 


T S P 


321 


T1 


-321 


T! 


322 


T2 


-322 


T" 


323 


T3 


-323 


T# 


324 


T4 


-324 


T$ 


325 


T5 


-325 


T% 


326 


T6 


-326 


T& 


327 


T7 


-327 


r 


328 


T8 


-328 


T( 


329 


T9 


-329 


T) 


330 


T: 


-330 


T* 


331 


T- 


— 331 


T + 


332 


T< 


-332 


T, 


333 


T= 


-333 


T- 


334 


T> 


-334 


T. 


335 


T? 


-335 


17 


336 


UO 


-336 


U s p 


337 


U1 


-337 


U! 


338 


U2 


-338 


U" 


339 


U3 


-339 


u# 


340 


U4 


-340 


us 


341 


U5 


-341 


u% 


342 


U6 


-342 


u& 


343 


U7 


-343 


U' 


344 


U8 


-344 


U( 


345 


U9 


-345 


U) 


346 


U: 


-346 


u* 


347 


U; 


-347 


u+ 


348 


U< 


-348 


u, 


349 


U= 


-349 


u- 



Table D-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-lnt b 


Param 


350 


U> 


-350 


U. 


351 


U? 


-351 


U/ 


352 


VO 


-352 


v s p 


353 


V1 


-353 


V! 


354 


V2 


-354 


V" 


355 


V3 


-355 


V# 


356 


V4 


-356 


V$ 


357 


V5 


-357 


v'% 


358 


V6 


-358 


V& 


359 


V7 


-359 


V 


360 


V8 


-360 


V( 


361 


V9 


-361 


V) 


362 


V: 


-362 


V* 


363 


V; 


-363 


v+ 


364 


V< 


-364 


v, 


365 


V = 


-365 


V- 


366 


v> 


-366 


V. 


367 


V? 


-367 


v/ 


368 


wo 


-368 


W s p 


369 


W1 


-369 


W! 


370 


W2 


-370 


W" 


371 


W3 


-371 


w# 


372 


W4 


-372 


w$ 


373 


W5 


-373 


w% 


374 


W6 


-374 


w& 


375 


W7 


-375 


w 


376 


W8 


-376 


W( 


377 


W9 


-377 


W) 


378 


W: 


-378 


w* 


379 


W; 


-379 


w+ 


380 


W< 


-380 


w, 


381 


W = 


-381 


w- 


382 


W> 


-382 


w. 


383 


W? 


383 


w/ 


384 


XO 


-384 


X S P 


385 


X1 


-385 


X! 


386 


X2 


-386 


X" 


387 


X3 


-387 


X# 


388 


X4 


-388 


X$ 


389 


X5 


-389 


X% 


390 


X6 


-390 


x& 


391 


X7 


-391 


X' 


392 


X8 


-392 


X( 


393 


X9 


-393 


X) 


394 


X: 


-394 


X* 


395 


X; 


-395 


x+ 


396 


X< 


-396 


x, 


397 


X = 


-397 


x- 


398 


X> 


-398 


X. 


399 


X? 


-399 


XI 



+ lnf 


Param 


-Int" 


Param 


400 


YO 


-400 


Y S P 


401 


Y1 


-401 


Y! 


402 


Y2 


-402 


Y" 


403 


Y3 


-403 


Y# 


404 


Y4 


-404 


Y$ 


405 


Y5 


-405 


Y% 


406 


Y6 


-406 


Y& 


407 


Y7 


— 407 


Y' 


408 


Y8 


-408 


Y( 


409 


Y9 


-409 


Y) 


410 


Y: 


-410 


Y* 


411 


Y; 


-411 


Y + 


412 


Y< 


-412 


Y, 


413 


Y = 


-413 


Y- 


414 


Y> 


-414 


Y. 


415 


Y? 


-415 


Y/ 


416 


ZO 


-416 


Z s p 


417 


Z1 


-417 


Z! 


418 


Z2 


-418 


Z" 


419 


Z3 


-419 


Z# 


420 


Z4 


-420 


z$ 


421 


Z5 


-421 


z% 


422 


Z6 


-422 


z& 


423 


Z7 


-423 


Z' 


424 


Z8 


-424 


Z( 


425 


Z9 


-425 


Z) 


426 


Z: 


-426 


z* 


427 


Z; 


-427 


z+ 


428 


Z< 


-428 


z, 


429 


Z = 


-429 


z- 


430 


Z> 


-430 


z. 


431 


z? 


-431 


z/ 


432 


fo 


-432 


[Sp 


433 


[1 


-433 


[! 


434 


[2 


-434 


[" 


435 


[3 


-435 


[# 


436 


[4 


-436 


[$ 


437 


[5 


-437 


[% 


438 


[6 


-438 


[& 


439 


[7 


-439 


[■ 


440 


[8 


-440 


[( 


441 


[9 


-441 


[) 


442 


I: 


-442 


[* 


443 


[; 


-443 


[+ 


444 


[< 


-444 


[. 


445 


[ = 


-445 


[- 


446 


[> 


-446 


[. 


447 


[? 


-447 


[/ 


448 


\o 


-448 


\ S P 


449 


\1 


-449 


\! 



Positive integer 
Negative integer 
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INTEGER PARAMETERS 



+ lnt" 


Pa ram 


-Int" 


Param 


450 


\2 


-450 


\" 


451 


\3 


-451 


\# 


452 


\4 


-452 


\$ 


453 


\5 


-453 


\% 


454 


\6 


-454 


\& 


455 


\7 


-455 


V 


456 


\8 


-456 


\( 


457 


\9 


-457 


\) 


458 


V 


-458 


\* 


459 


\; 


-459 


\+ 


460 


\< 


-460 


\, 


461 


\= 


-461 


\- 


462 


\> 


-462 


\. 


463 


\? 


-463 


\/ 


464 


]0 


-464 


]Sp 


465 


]1 


-465 


]! 


466 


]2 


-466 


]" 


467 


]3 


-467 


]# 


468 


]4 


-468 


]$ 


469 


]5 


-469 


]% 


470 


]6 


-470 


]& 


471 


F 


-471 


]' 


472 


)8 


-472 


]( 


473 


]9 


-473 


]) 


474 


]: 


-474 


]* 


475 


l; 


-475 


] + 


476 


]< 


-476 


]. 


477 


] = 


-477 


]- 


478 


]> 


-478 


]- 


479 


]? 


-479 


]/ 


480 


AO 


-480 


A S P 


481 


A1 


-481 


A! 


482 


A2 


482 


A" 


483 


A3 


-483 


A# 


484 


A4 


-484 


A$ 


485 


A5 


-485 


A% 


486 


A6 


-486 


A& 


487 


A7 


-487 


A' 


488 


A8 


-488 


A( 


489 


A9 


-489 


A) 


490 


A: 


-490 


A* 


491 


A; 


-491 


A + 


492 


A< 


-492 


A, 


493 


A = 


-493 


A- 


494 


A> 


-494 


A. 


495 


A? 


-495 


A/ 


496 


_0 


-496 


_ S P 


497 


_1 


-497 


_J 


498 


JL 


-498 


JI 


499 


_3 


-499 


_# 



Table D-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


500 


_4 


-500 


$ 


501 


_5 


-501 


_% 


502 


_6 


-502 


_& 


503 


_7 


-503 


» 


504 


_8 


-504 


( 


505 


_9 


-505 


-) 


506 


_: 


-506 


* 


507 


— , 


-507 


_+ 


508 


_< 


-508 


_, 


509 


_= 


-509 


_- 


510 


_> 


-510 





511 


_? 


-511 


_/ 


512 


'0 


-512 


s p 


513 


'1 


-513 


! 


514 


'2 


-514 


D 


515 


'3 


-515 


# 


516 


'4 


-516 


$ 


517 


'5 


-517 


% 


518 


'6 


-518 


& 


519 


'7 


-519 


' 


520 


'8 


-520 


( 


521 


'9 


521 


) 


522 


t. 


-522 


* 


523 


t. 

J 


-523 


+ 


524 


'< 


-524 


» 


525 


i 


-525 


- 


526 


'> 


-526 




527 


'? 


-527 


/ 


528 


aO 


-528 


a s p 


529 


a1 


-529 


a! 


530 


a2 


-530 


a" 


531 


a3 


-531 


a# 


532 


a4 


-532 


aS 


533 


a5 


-533 


a% 


534 


a6 


-534 


a& 


535 


a7 


-535 


a' 


536 


a8 


-536 


a( 


537 


a9 


-537 


a) 


538 


a: 


-538 


a* 


539 


a; 


-539 


a + 


540 


a< 


-540 


a, 


541 


a= 


-541 


a — 


542 


a> 


-542 


a. 


543 


a? 


-543 


a/ 


544 


bO 


-544 


b s p 


545 


b1 


-545 


b! 


546 


b2 


-546 


b" 


547 


b3 


-547 


b# 


548 


b4 


-548 


bS 


549 


b5 


-549 


b% 



+ Int" Param 



550 


b6 


551 


b7 


552 


b8 


553 


b9 


554 


b: 


555 


b; 


556 


b< 


557 


b= 


558 


b> 


559 


b? 


560 


cO 


561 


d 


562 


c2 


563 


c3 


564 


C4 


565 


c5 


566 


c6 


567 


c7 


568 


c8 


569 


c9 


570 


c: 


571 


c; 


572 


c< 


573 


c= 


574 


c> 


575 


c? 


576 


dO 


577 


d1 


578 


d2 


579 


d3 


580 


d4 


581 


d5 


582 


d6 


583 


d7 


584 


d8 


585 


d9 


586 


d: 


587 


d; 


588 


d< 


589 


d = 


590 


d> 


591 


d? 


592 


eO 


593 


e1 


594 


e2 


595 


e3 


596 


e4 


597 


e5 


598 


e6 


599 


e7 



-Int" 



Param 



550 


b& 


551 


b' 


552 


b( 


553 


b) 


554 


b* 


555 


b + 


556 


b, 


557 


b- 


558 


b. 


559 


b/ 


560 


C S P 


561 


c! 


562 


c" 


563 


c# 


564 


c$ 


565 


c% 


566 


c& 


567 


c' 


568 


c( 


569 


c) 


570 


c* 


571 


c + 


572 


c, 


573 


c- 


574 


c. 


575 


c/ 


576 


d s p 


577 


d! 


578 


d" 


579 


d# 


580 


d$ 


581 


d% 


582 


d& 


583 


d' 


584 


d( 


585 


d) 


586 


d* 


587 


d+ 


588 


d, 


589 


d- 


590 


d. 


591 


d/ 


592 


e s p 


593 


e! 


594 


e" 


595 


e# 


596 


e$ 


597 


e% 


598 


e& 


599 


e' 



Positive integer 
Negative integer 



D-4 
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INTEGER PARAMETERS 



Table D-1 (cont) 
INTEGER PARAMETERS 



+ lnf 


Param 


-Int" 


Param 


+ lnt' 


>aram 


-Int" 


Param 


+ lnt' 


Param 


-Int" 


Param 


600 


e8 


-600 


e( 


650 


h: 


-650 


h* 


700 


k< 


-700 


k, 


601 


e9 


-601 


e) 


651 


h; 


-651 


h + 


701 


k = 


-701 


k- 


602 


e: 


-602 


e* 


652 


h< 


-652 


h, 


702 


k> 


-702 


k. 


603 


e; 


-603 


e+ 


653 


h= 


-653 


ti- 


703 


k? 


-703 


k/ 


604 


e< 


-604 


e, 


654 


h> 


-654 


ll. 


704 


10 


-704 


I s p 


605 


e= 


-605 


8 — 


655 


•i? 


-655 


h/ 


705 


11 


-705 


!! 


606 


e> 


-606 


e. 


656 





-656 


i s P 


706 


12 


-706 


I" 


607 


e? 


-607 


el 


657 


1 


-657 


i! 


707 


13 


-707 


l# 


608 


fO 


-608 


f s P 


658 


2 


-658 


i" 


708 


14 


-708 


IS 


609 


f1 


-609 


f! 


659 


3 


-659 


i# 


709 


15 


-709 


l% 


610 


f2 


-610 


f" 


660 


4 


-660 


i$ 


710 


16 


-710 


l& 


611 


f3 


-611 


f# 


661 


5 


-661 


i% 


711 


17 


-711 


I' 


612 


f4 


-612 


f$ 


662 


6 


-662 


i& 


712 


18 


-712 


H 


613 


f5 


-613 


f% 


663 


7 


-663 


i' 


713 


19 


-713 


1) 


614 


f6 


-614 


f& 


664 


8 


-664 


u 


714 


!: 


-714 


1* 


615 


f7 


-615 


f 


665 


9 


-665 





715 


I; 


-715 


i + 


616 


f8 


-616 


f( 


666 




-666 


i* 


716 


!< 


-716 


!. 


617 


f9 


-617 


f) 


667 


» 


-667 


i + 


717 


1 = 


-717 


1- 


618 


f: 


-618 


f* 


668 


< 


-668 


i, 


718 


l> 


-718 


1. 


619 


f; 


-619 


f+ 


669 


= 


-669 


i- 


719 


1? 


-719 


1/ 


620 


f< 


-620 


f, 


670 


> 


-670 


i. 


720 


mO 


720 


m s p 


621 


f= 


-621 


f- 


671 


? 


-671 


V 


721 


ml 


-721 


m! 


622 


f> 


-622 


f. 


672 





-672 


i s P 


722 


m2 


-722 


m" 


623 


f? 


-623 


V 


673 


1 


-673 


j! 


723 


m3 


-723 


m# 


624 


go 


-624 


g s p 


674 


2 


-674 


j" 


724 


m4 


-724 


mS 


625 


gi 


-625 


g! 


675 


3 


-675 


i# 


725 


m5 


-725 


m% 


626 


g2 


-626 


g" 


676 


4 


-676 


j$ 


726 


m6 


-726 


m& 


627 


g3 


-627 


g# 


677 


5 


-677 


j% 


727 


m7 


-727 


m' 


628 


g« 


-628 


g$ 


678 


6 


-678 


j& 


728 


m8 


-728 


m( 


629 


gs 


-629 


g% 


679 


7 


-679 


j' 


729 


m9 


-729 


m) 


630 


ge 


-630 


g& 


680 


8 


-680 


j( 


730 


m: 


-730 


m* 


631 


g7 


-631 


g' 


681 


9 


-681 


j) 


731 


m; 


-731 


m + 


632 


gs 


-632 


g( 


682 




-682 


j* 


732 


m< 


-732 


m, 


633 


g9 


-633 


g) 


683 


1 


-683 


j+ 


733 


m= 


-733 


m— 


634 


g= 


-634 


g* 


684 


< 


-684 


j. 


734 


m> 


-734 


m. 


635 


g; 


-635 


g+ 


685 i 


= 


-685 


j- 


735 


m? 


-735 


ml 


636 


g< 


-636 


g. 


686 ) 


> 


-686 


i- 


736 


nO 


-736 


n s P 


637 


g= 


-637 


g- 


687 j 


? 


-687 


i/ 


737 


n1 


-737 


n! 


638 


g> 


-638 


g- 


688 


<0 


-688 


k s p 


738 


n2 


-738 


n" 


639 


g? 


639 


9/ 


689 


<1 


-689 


k! 


739 


n3 


-739 


n# 


640 


h0 


-640 


h s p 


690 


<2 


-690 


k" 


740 


n4 


-740 


n$ 


641 


hi 


-641 


h! 


691 


<3 


-691 


k# 


741 


n5 


-741 


n% 


642 


h2 


-642 


h" 


692 


<4 


-692 


k$ 


742 


n6 


-742 


n& 


643 


h3 


-643 


h# 


693 


<5 


-693 


k% 


743 


n7 


-743 


n' 


644 


h4 


-644 


h$ 


694 


<6 


-694 


k& 


744 


n8 


-744 


n( 


645 


h5 


-645 


h% 


695 


<7 


-695 


k' 


745 


n9 


-745 


n) 


646 


h6 


-646 


h& 


696 


<8 


-696 


k( 


746 


n: 


-746 


n* 


647 


h7 


-647 


h' 


697 


<9 


-697 


k) 


747 


n; 


-747 


n + 


648 


h8 


-648 


h( 


698 


<: 


-698 


k* 


748 


n< 


-748 


n, 


649 


h9 


-649 


h) 


699 


<; 


-699 


k+ 


749 


n = 


-749 


n — 



Positive integer 
Negative integer 



For integers ± 704 through ± 719, the first char- 
acter of the parameter is a lowercase I (A DE f08). 
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INTEGER PARAMETERS 



+ lnf 


Param 


-Int b 


Param 


750 


n> 


-750 


n. 


751 


n? 


-751 


n/ 


752 


oO 


-752 


S P 


753 


01 


-753 


o! 


754 


o2 


-754 


0" 


755 


03 


-755 


0# 


756 


04 


-756 


0$ 


757 


05 


-757 


0% 


758 


06 


-758 


o& 


759 


07 


-759 


0' 


760 


08 


-760 


o( 


761 


09 


-761 


o) 


762 


o: 


-762 


0* 


763 


o; 


-763 


+ 


764 


o< 


-764 


0, 


765 


= 


-765 


o- 


766 


0> 


-766 


0. 


767 


0? 


-767 


0/ 


768 


pO 


-768 


p s p 


769 


p1 


-769 


p! 


770 


p2 


-770 


P" 


771 


P 3 


-771 


p# 


772 


P 4 


-772 


p$ 


773 


p5 


-773 


p% 


774 


p6 


-774 


p& 


775 


P7 


-775 


p' 


776 


p8 


-776 


p( 


777 


p9 


-777 


p) 


778 


P: 


-778 


p* 


779 


p; 


-779 


p+ 


780 


P< 


-780 


p, 


781 


P = 


-781 


p- 


782 


P> 


-782 


p- 


783 


P? 


-783 


p/ 


784 


qO 


-784 


q s p 


785 


q1 


-785 


q! 


786 


q2 


-786 


q" 


787 


q3 


-787 


q# 


788 


q4 


-788 


q$ 


789 


q5 


-789 


q% 


790 


q6 


-790 


q& 


791 


q7 


-791 


q' 


792 


q8 


-792 


q( 


793 


q9 


-793 


q) 


794 


q: 


-794 


q* 


795 


q; 


-795 


q + 


796 


q< 


-796 


q> 


797 


q= 


-797 


q- 


798 


q> 


-798 


q- 


799 


q? 


-799 


q/ 



Table D-1 (cont) 
INTEGER PARAMETERS 



+ lnt" 


Param 


-Int" 


Param 


800 


rO 


-800 


r s P 


801 


r1 


-801 


r! 


802 


r2 


-802 


r" 


803 


r3 


-803 


r# 


804 


r4 


-804 


r$ 


805 


r5 


-805 


r% 


806 


r6 


-806 


r& 


807 


r7 


-807 


r' 


808 


r8 


-808 


r( 


809 


r9 


-809 


r) 


810 


v 


810 


r* 


811 


r; 


-811 


r+ 


812 


r< 


-812 


r, 


813 


r= 


-813 


r— 


814 


r> 


-814 


r. 


815 


r? 


-815 


r/ 


816 


sO 


-816 


S S P 


817 


s1 


-817 


s! 


818 


S2 


-818 


s" 


819 


S3 


-819 


s# 


820 


S4 


-820 


s$ 


821 


S5 


-821 


s% 


822 


s6 


-822 


s& 


823 


S7 


-823 


s' 


824 


s8 


-824 


s( 


825 


s9 


-825 


s) 


826 


s: 


-826 


s* 


827 


s; 


-827 


s + 


828 


s< 


-828 


s, 


829 


s = 


-829 


s- 


830 


s> 


-830 


s. 


831 


s? 


-831 


s/ 


832 


to 


-832 


1 S P 


833 


t1 


-833 


t! 


834 


t2 


-834 


t" 


835 


t3 


-835 


t# 


836 


t4 


-836 


t$ 


837 


t5 


-837 


t% 


838 


t6 


-838 


t& 


839 


t7 


-839 


t' 


840 


t8 


-840 


t( 


841 


t9 


-841 


t) 


842 


t: 


-842 


t* 


843 


t; 


843 


t+ 


844 


t< 


-844 


t, 


845 


t= 


-845 


t- 


846 


t> 


-846 


t. 


847 


t? 


-847 


XI 


848 


uO 


-848 


U S P 


849 


u1 


-849 


u! 



+ Int" Param 



850 
851 
852 
853 
854 
855 
856 
857 
858 
859 



u2 
u3 
u4 
u5 
u6 
u7 
u8 
u9 
u: 

u; 



-lnt° 



-850 
-851 
-852 

853 
-854 
-855 
-856 
-857 
-858 

859 

. BRO 



Param 



u" 

u# 

u$ 

u% 

u& 

u' 

u( 

u) 

u* 

u + 



861 


u = 


-861 


u — 


862 


u> 


-862 


u. 


863 


u? 


-863 


u/ 


864 


vO 


-864 


V S P 


865 


v1 


-865 


v! 


866 


v2 


-866 


v" 


867 


v3 


-867 


v# 


868 


v4 


-868 


v$ 


869 


v5 


-869 


v% 


870 


v6 


-870 


v& 


871 


v7 


-871 


V' 


872 


v8 


-872 


v( 


873 


v9 


-873 


v) 


874 


v: 


-874 


V* 


875 


v; 


-875 


v + 


876 


v< 


-876 


V, 


877 


v = 


-877 


v — 


878 


v> 


-878 


V. 


879 


V? 


-879 


v/ 


880 


wO 


-880 


W S P 


881 


w1 


-881 


w! 


882 


w2 


-882 


w" 


883 


w3 


-883 


w# 


884 


w4 


-884 


w$ 


885 


w5 


-885 


w% 


886 


w6 


-886 


w& 


887 


w7 


-887 


w' 


888 


w8 


-888 


w( 


889 


w9 


-889 


w) 


890 


w: 


-890 


w* 


891 


w; 


-891 


w+ 


892 


w< 


-892 


w, 


893 


w = 


-893 


w— 


894 


w> 


-894 


w. 


895 


w? 


-895 


w/ 


896 


xO 


-896 


X S P 


897 


x1 


-897 


x! 


898 


x2 


-898 


X" 


899 


x3 


-899 


X# 



Positive integer 
Negative integer 
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Table D-1 (cont) 
INTEGER PARAMETERS 



INTEGER PARAMETERS 



+ lnt" 


Param 


-Int" 


Param 


+ lnf 


Param 


-Int" 


Param 


+ lnf 


Param 


-lnt b 


Param 


900 


x4 


-900 


x$ 


950 


(6 


-950 


{* 


1000 


~8 


-1000 


~« 


901 


x5 


-901 


x% 


951 


{7 


-951 


v 


1001 


~9 


-1001 


~) 


902 


x6 


-902 


x& 


952 


{8 


-952 


i< 


1002 


~: 


-1002 


___ * 


903 


x7 


-903 


x' 


953 


19 


-953 


i) 


1003 


*" ) 


-1003 


~ + 


904 


x8 


-904 


x( 


954 
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Positive integer 
Negative integer 



For integers ±960 through ±975, the first char- 
acter of the parameter is a vertical bar (A DE 124.). 
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Appendix E 

TEKTRONIX COLOR STANDARD 



100%— 



In the HLS color coordinate system, 
the color space is represented as a 
double-ended cone. 

The HUE coordinate runs 
counterclockwise around the 
cone. (0 to 360 degrees.) 

The LIGHTNESS coordinate runs 
vertically up the cone. (0% to 100%. 



The SATURATION coordinate runs 
radially outward from the axis of 
the cone. The SATURATION coordinate 
is a percentage of the maximum 
possible saturation at a particular 
LIGHTNESS level. (0% to 100%.) 




0%- 1 - 



ill 

z 
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TEKTRONIX 

COLOR 

STANDARD 



Overview: 

The world of color is filled with ambiguous 
terminology, i.e. intensity, purity, value, etc. 
Many color users feel that "color theory" is a 
prerequisite to operating color systems; T.V., 
Videotaping, Photography, Computer Graph- 
ics. 

In order to end this confusion, Tektronix has 
developed a color language and function 
based on human engineering, rather than 
machine engineering. Below is a description 
of this system, which will provide a clear 
and concise means for understanding how 
color is defined and how our syntax was 
derived. 

Color Concepts: 

Color selection is specified by hue, light- 
ness and saturation which is the HLS 
method. The definitions are as follows: 



Saturation: The characteristic which 

describes the extent to 
which a color differs from 
a gray of the same light- 
ness. Saturation is ex- 
pressed as percentage, 
ranging from 0% (maxi- 
mum white content at that 

uLji hi iCOO iCvCi/ iu \\juhj 

(full saturated). 

Geometrically, colors can be described in 
terms of a double cone. 
Variations in lightness are represented 
along the axis, with white at the apex of 
the cone and black at the opposite apex. 
Variations in saturation are represented by 
radial distances from the lightness axis, in 
constant lightness planes. Hue is repre- 
sented as an angular quantity from a known 
reference point. 



Hue: 



Lightness: 



The characteristic associ- 
ated with a color name 
such as red, yellow, green, 
blue, etc. Hue is a grada- 
tion of color advanced by 
degrees, thus represented 
as an angle from to 360. 

The characteristic that al- 
lows the color to be 
ranked on a scale from 
dark to light. Lightness is 
expressed as a parameter 
ranging from to 100% 
with black being (bot- 
tom of cone) and white 
being 100% (top of cone). 



Copyright © 1982 by Tektronix, Inc., Beaverton, Oregon. 
Printed in the United States of America. All rights reserved. 
Contents of this publication may not be reproduced in any form 
without permission of Tektronix, Inc. U.S.A. and foreign TEK- 
TRONIX products covered by U.S. and foreign patents and/or 
patents pending. 

TEKTRONIX is a registered trademark for Tektronix, Inc. 
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Alpha cursor, 5-61 
Alpha cursor position, 5-56 
Alpha mode, 3-2, 5-28 
Alphatext, 3-2, 3-10 

size, 3-10 
Alternate Keypad mode, 4-5 

entering, 4-26 

exiting, 4-27 

programming codes, 4-26 
ALU mode, 3-34,5-12 
ANSI commands 

b l (Bell character), 4-8 

B s (Backspace character), 4-8 

c n (Cancel character), 4-8 

c r (Carriage Return character), 4-8 

f f (Formfeed character), 4-1 2 

h t (Horizontal Tab character), 4-1 2 

l f (Linefeed character), 4-13 

s b (Sub character),4-1 7 

s i (Shift In character), 4-20 

s o (Shift Out character), 4-20 

s p (Space character), 4-21 

v t (Vertical Tab character), 4-24 

CBT (Cursor Backward Tab), 4-8 

CHT (Cursor Horizontal Tab), 4-8 

CPR (Cursor Position Report), 4-8 

CUB (Cursor Backward), 4-9 

CUD (Cursor Down), 4-9 

CUF (Cursor Forward), 4-9 

CUP (Cursor Position), 4-9 

CUU (Cursor Up), 4-10 

DA (Device Attributes), 4-10 

DCH (Delete Character), 4-10 

DL (Delete Line), 4-10 

DMI (Disable Manual Input), 4-1 1 

DSR (Device Status Report), 4-1 1 

ECH (Erase Character), 4-1 1 

ED (Erase in Display), 4-1 1 

EL (Erase in Line), 4-12 

EMI (Enable Manual Input), 4-12 

HVP (Horizontal and Vertical Position), 4-12 

ICH (Insert Character), 4-13 

IL (Insert Line), 4-13 

IND (Index), 4-13 

NEL (Next Line), 4-1 3 



ANSI commands (cont) 

REPORT SYNTAX MODE, 4-14 

Rl (Reverse Index), 4-14 

RIS (Return to Initial State), 4-14 

RM (Reset Modes), 4-14 

SCS (Select Character Set), 4-1 7 

SD (Scroll Down), 4-17 

SELECT CODE, 4-1 8 

SGR (Select Graphic Rendition), 4-18 

SL (Scroll Left), 4-20 

SM (Set Mode), 4-20 

SR (Scroll Right), 4-21 

SU (Scroll Up), 4-21 

TBC (Tab Clear), 4-21 

TEKDHL (Double Height Line), 4-22 

TEKDWL (Double Width Line), 4-22 

TEKID (Identify Terminal), 4-22 

TEKKPAM (Keypad Application Mode), 4-23 

TEKKPNM (Keypad Numeric Mode), 4-23 

TEKRC (Restore Cursor), 4-23 

TEKSC (Save Cursor), 4-24 

TEKSTBM (Set Top and Bottom Margins), 4-24 

TEKSWL (Single Width Line), 4-24 

(Underscore character), 4-24 
Ansi mode, 4-4, 1-4 

command conventions, 4-6 

commands grouped by function, 4-7 

commands, 4-8 — 4-24 

entering, 4-18, 4-26, 4-28 
Ansko-VT52 mode (TEKANM), 4-15, 4-16 
ANSI X3.84, 4-1 , 4-5, 1-1 , 1-3, 1-4 
ASCII code chart, A-3 
Aspect ratio, 3-1 6 

Asynchronous serial data communications, 2-2 
Attributes 

graphtext, 3-8 

of lines, 3-6 

of segments, 3-12 

view, 3-20 
Autorepeat mode (TEKARM), 4-15, 4-16 
Autowrap mode (TEKAWM), 4-15, 4-16 

Background index, 4-18, 4-19. See also Wipe index. 
Backspace character ( B s), 4-8 
Baud rate, 2-1 , 5-64 
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BEGIN GRAPHTEXT CHARACTER, 5-8 

BEGIN HIGHER SEGMENT, 5-9 , 3-10, 3-12 

BEGIN LOWER SEGMENT, 5-9, 3-10, 3-12 

BEGIN NEW SEGMENT, 5-10, 3-10, 3-12 

BEGIN PANEL BOUNDARY, 5-10, 3-7 

BEGIN PIXEL OPERATIONS, 5-12, 3-34, 3-35, 3-36 

BEGIN SEGMENT, 5-13, 3-10, 3-12 

Bell character ( b l), 4-8 

Bit planes, 3-20 

Bits-per-pixel, 5-12, 5-58 

b l (Bell character), 4-8 

Blinking display, 4-19 

Bold display, 4-19 

Border index, 5-118 

Break key, 2-2, 5-65 

Break time, 2-2, 5-65 

B s (Backspace character), 4-8 

Buffer, dialog, 4-2 

Bypass-cancel character, 2-2, 5-65, 5-29 

Bypass mode, 2-2, 5-29 

CANCEL, 5-13 

Cancel character ( c n), 4-8 

Carriage Return character ( c r), 4-8 

CBT (Cursor Backward Tab), 4-8 

Character array parameter (Host), 5-1 

Character background, 3-3 

Character color, 3-3 

Character parameter (Setup), 5-1 

Character path, 5-66 

Character path settings, 5-66 

Character sets, 4-1 7, A1 — A1 

Characters 

bypass-cancel, 2-2, 5-65, 5-29 

EOM (end-of-message), 2-5, 5-76 

filler ( d t), 2-3 

key-execute, 5-16, 5-92 

sets, 4-1 7, A1— A10 

signature, 3-29, 5-46, 5-104 

terminal signature, 5-48 

turnaround, 5-76 
CHT (Cursor Horizontal Tab), 4-8 
CLEAR DIALOG SCROLL, 5-14, 3-3 
Clear to Send (CTS), 2-4 
Clipping, 5-121 
CMY color system, 5-67 
c n (Cancel character), 4-8 



Color 

blinking, 3-27 

coordinates, 3-26, 5-62 

display, 3-26 

effective displays, 3-28 

in dialog area, 3-3 

in graphics area, 3-26 

indices, 3-26 

interface, 3-26 
Color index codes, 5-40 
Color indices, 3-26 

default, 3-22,5-70,5-114 
Color map 

dialog area, 5-70 

surface, 5-113 
Coior mixtures, 3-27, 5-70 

default assignments, 3-22, 5-70, 5-114 

defining, 3-27 

initializing, 5-114 
Color Overlay mode, 5-68 

additive, 5-68 

opaque, 5-68 

subtractive, 5-68 
Color specifying mode, 5-67 
Color system 

CMY (cyan, magenta, yellow), 3-26, 5-67 

HLS (hue, lightness, saturation), 3-26, 5-67 

RGB (red, green, blue), 3-26, 5-67 
Column address, 4-1 
Column mode (TEKCOLM), 4-15, 4-16 
Command conventions 

ANSI and VT52, 4-6 

4100-style,5-6 
Command description format. See Command conventions. 
Commands 

Ansi mode, 4-7 — 4-24 

conventions, 4-6, 5-6 

report, 2-5 — 2-6 

VT52 mode, 4-25 — 4-28 

4100-style, 5-8 — 5-123 
Communications, 2-1 — 2-7 

asynchronous serial, 2-2 

full-duplex, 2-2 

host, 2-1 — 2-6 

port, 2-7 
COPY, 2-7, 5-14 

CPR (Cursor Position Report), 4-8 
c r (Carriage Return character), 4-8 
CRLF,5-14 
Crosshair cursor, 3-1 3 
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CTS (Clear to Send), 2-4 
CUB (Cursor Backward), 4-9 
CUD (Cursor Down), 4-9 
CUF (Cursor Forward), 4-9 
CUP (Cursor Position), 4-9, 4-2 
Current 

graphtext font, 5-8 

line, 4-1 

position, 3-4 

viewport, 3-16 
Cursor, 4-1 

address, 4-1 

alpha, 5-61 

crosshair, 3-13 
Cursor Backward (CUB), 4-9 
Cursor Backward Tab (CBT), 4-8 
Cursor Commands, ANSI 

CBT (Cursor Backward Tab), 4-8 

CHT (Cursor Horixontal Tab), 4-8 

CUB (Cursor Backward), 4-9 

CUD (Cursor Down), 4-9 

CUF (Cursor Forward), 4-9 

CUP (Cursor Position), 4-9 

CUU (Cursor Up), 4-10 

TEKRC (Restore Cursor), 4-23 

TEKSC (Save Cursor), 4-24 
Cursor commands, VT52 

CURSOR DOWN, 4-25 

CURSOR LEFT, 4-25 

CURSOR RIGHT, 4-25 

CURSOR TO HOME, 4-25 

CURSOR UP, 4-25 
CURSOR DOWN, 4-25 
Cursor Down (CUD), 4-9 
Cursor Forward (CUF), 4-9 
Cursor Horizontal Tab (CHT), 4-8 
Cursor Keys mode (TEKCKM), 4-15, 4-16 
CURSOR LEFT, 4-25 
CURSOR RIGHT, 4-25 
CURSOR TO HOME, 4-25 
Cursor position, 4-1 
Cursor Position (CUP), 4-9 
CURSOR UP, 4-25 
Cursor Up (CUU), 4-10 
CUU (Cursor Up), 4-10 

DA (Device Attributes), 4-10 
Danish character set, 4-17, A-7 
Data Terminal Ready (DTR), 2-4 
DCH (Delete Character), 4-10 



DC1/DC3 flagging, 2-4, 5-78 

Default color indices, 3-22, 5-70, 5-114 

Default view, 5-61 

DEFINE MACRO, 5-15, 3-31 

DEFINE NONVOLATILE MACRO, 5-18, 3-31 

Delete Character (DCH), 4-1 

Delete Line (DL), 4-10 

DELETE GRAPHTEXT CHARACTER, 5-19 

DELETE SEGMENT, 5-19, 3-12 

DELETE VIEW, 5-20, 3-19 

Delta mode device, 5-24 

Device Attributes (DA), 4-10 

Device codes, 5-23 

Device Status Report 
Tek mode, 5-43 
Ansi mode, 4-1 1 

Device-function, 5-79 

Device-function codes, 5-23 

Dialog area, 3-2, 4-1 
commands, 3-3 
disabling, 5-22 
enabling, 3-3, 5-22 
visibility, 3-3 

Dialog area commands 
CLEAR DIALOG SCROLL, 5-14, 3-3 
ENABLE DIALOG AREA, 5-22, 3-3 
SET DIALOG AREA BUFFER SIZE, 5-69, 3-3 
SET DIALOG AREA COLOR MAP, 5-70, 3-3 
SET DIALOG AREA INDEX, 5-71 , 3-3 
SET DIALOG AREA LINES, 5-71 , 3-3 
SET DIALOG AREA VISIBILITY, 5-72, 3-3 
SET DIALOG AREA WRITING MODE, 5-72, 3-3 

Dialog background, 3-3 

Dialog buffer, 3-2, 4-2 

Dialog key, 4-1 

DIRECT CURSOR ADDRESS.4-26 

DISABLE GIN, 5-20, 3-30 

Disable Manual Input (DMI), 4-1 1 

Display cluster, 5-1 1 9 

Distance filter, 5-85 

DL (Delete Line), 4-10 

DMI (Disable Manual Input), 4-1 1 

Double Height Line (TEKDHL), 4-22 

Double Width Line (TEKDWL), 4-22 

DRAW, 5-21 , 3-6 

DRAW MARKER, 5-21 , 3-6 

DSR (Device Status Report), 4-1 1 

d t filler character, 2-3, 5-32 

DTR (Data Terminal Ready), 2-4 

DTR/CTS flagging, 2-4, 5-78 
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ECH (Erase Character), 4-1 1 
Echo, 2-1 , 5-74 

local, 2-1 , 5-74 

remote, 2-1 , 5-74 
ED (Erase in Display), 4-1 1 , 
Edit margins, 4-2, 4-24 
Edit mode, 4-1 , 4-5 

entering, 4-18, 4-28, 5-59 
Editing, 4-1 — 4-24 
EL (Erase in Line), 4-12 
EMI (Enable Manual Input), 4-12 
Emulating 401 Series Graphics Input, 5-26 
ENABLE DIALOG AREA, 5-22 , 3-3 
ENABLE GIN, 5-23, 3-28, 3-30 
ENABLE KEY EXPANSION, 5-25 
Enable Manual Input (EMI), 4-12 
ENABLE 4010 GIN, 5-25, 3-28, 3-30 
END GRAPHTEXT CHARACTER, 5-28 
End-of-file string (EOF), 5-75 

port, 5-99 
End-of-line string (EOL), 5-75 
End-of-message character (EOM), 5-76 
END PANEL, 5-28, 3-7 
END SEGMENT, 5-28, 3-10, 3-12 
ENTER ALPHA MODE, 5-28, 3-6 
ENTER ALTERNATE KEYPAD MODE, 4-5, 4-26 
ENTER ANSI MODE, 4-26 
ENTER BYPASS MODE, 5-29, 2-2 
ENTER GRAPHICS MODE, 4-27 
ENTER MARKER MODE, 5-29, 3-6 
ENTER VECTOR MODE, 5-29, 3-5 
EOF (end-of-file) string, 5-75 
EOL (end-of-line) string, 2-5, 5-75 
EOM (end-of-message) character, 2-5, 5-76 
EOM indicators, 5-46, 5-102 
Erase Character (ECH), 4-1 1 
Erase in Display (ED), 4-1 1 
Erase index, 4-18,4-19 
Erase in Line (EL), 4-12 
ERASE TO END OF LINE, 4-27 
ERASE TO END OF SCREEN, 4-27 
Erasure commands, ANSI 

ECH (Erase Character), 4-1 1 

ED (Erase in Display), 4-1 1 

EL (Erase in Line), 4-12 
Erasure commands, VT52 

ERASE TO END OF LINE, 4-27 

ERASE TO END OF SCREEN, 4-27 
Error Report, 5-44 

Message, 5-44 



Even parity, 5-94 

Exclusion set, 5-69 

EXIT ALTERNATE KEYPAD MODE, 4-27 

EXIT GRAPHICS MODE, 4-27 

EXPAND MACRO, 5-30, 3-31 

FACTORY, 5-31 
Features, 1-2 

alphanumerics 

alternate character sets, 1-2 

color hardcopy, 1 -3 

color, 1 -2 

computer interface, 1-3 

dialog area, 1-2 

graphics area. 1-2 

graphics input (GIN), 1-2 

graphics, 1-2 

keyboard, 1-3 

multiple views, 1-2 

nonvolatile memory, 1-2 

peripheral ports, 1-3 

software compatibility, 1-3 

the display, 1-2 

Zoom and Pan, 1-2 
f f (Formfeed character), 4-12 
Filler characters, 2-3 

d t, 2-3, 5-32 

E c?, 2-3 
Final GIN report item, 5-48 
Fixed region, 4-2 
Fixup level, 5-77 
Flagging, 2-4, 5-78, 5-99 

DC1/DC3.2-4 

DTR/CTS, 2-4 

port, 5-99 
Foreground index, 4-18, 4-19 
Formfeed character ( f f), 4-12 
French character set, 4-17, A-5 
Full-duplex data communications, 2-2 
Function code numbers, 5-23 
Function 

Locator, 3-29, 5-24 

Pick, 3-29, 5-24 

Stroke, 3-29, 5-24 

G Eras key, 5-37 
German character set, 4-17, A-8 
GIN. See Graphics input. 
GIN event, 3-29, 5-25 

GIN report items, 5-46 
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GIN reports, 3-29, 5-46 

GIN Locator Report, 3-29, 5-48 

GIN Pick Report, 3-29, 5-48 

GIN Stroke Report, 3-29, 5-49 

report sequence, 5-46 

4010 GIN Report, 3-30, 5-26 
GRAPHIC TEXT, 5-31, 3-8 
Graphics, 3-1 — 3-36 
Graphics beam position, 3-4 
Graphics cursor position, 5-56 
Graphics input (GIN), 3-28 

enabling, 3-28 

GIN event, 3-29 

GIN report, 3-29 

typical sequences, 3-28 
Graphics input commands, 3-30 

DISABLE GIN, 5-20, 3-30 

ENABLE 4010 GIN, 5-25, 3-30 

ENABLE GIN, 5-23, 3-30 

SET GIN AREA, 5-78, 3-30 

SET GIN CURSOR COLOR, 5-81 , 3-30 

SET GIN DISPLAY START POINT, 5-82, 3-30 

SET GIN GRIDDING, 5-82, 3-30 

SET GIN INKING, 5-83, 3-30 

SET GIN RUBBERBANDING, 5-84, 3-30 . 

SET GIN STROKE FILTERING, 5-85, 3-30 

SET GIN WINDOW, 5-86, 3-30 

SET PICK APERTURE, 5-95, 3-30 
Graphics input functions, 3-29 

Locator, 3-29, 5-24 

Pick, 3-29, 5-24 

Stroke, 3-29, 5-24 
Graphics input reports, 3-30 

GIN Locator Report, 3-30, 5-48 

GIN Pick Report, 3-30, 5-48 

GIN Stroke Report, 3-30, 5-49 

report sequence, 3-30 

4010 GIN Report, 3-30, 5-26 
Graphics mode, 4-5 
Graphics primitives, 3-1 1 

attributes of, 3-1 1 

DRAW, 3-1 1 

graphtext, 3-11 

MOVE, 3-11 

panels, 3-1 1 

Pick-ID, 3-1 1 

within segments, 3-1 1 



Graphtext characters, 3-33 
defining, 3-33, 5-8 
string precision, 3-8, 3-33 
stroke precision, 3-8, 3-33 

Graphtext font 
current, 5-8 
predefined, 5-89, 5-8, 3-33 

Graphtext, 3-8 
attributes, 3-8 
enlarging, 3-8, 5-91 
rotating, 3-8, 5-90 
string precision, 3-8, 5-31 , 5-89 
stroke precision, 3-8, 5-31 , 5-89 
writing, 5-31 

Graphtext commands 
BEGIN GRAPHTEXT CHARACTER, 5-8, 3-33 
DELETE GRAPHTEXT, 5-19 , 3-33 
END GRAPHTEXT CHARACTER, 5-28, 3-33 
GRAPHIC TEXT, 5-31, 3-8 
SET CHARACTER PATH, 5-66, 3-8 
SET GRAPHTEXT FONT, 5-87, 3-8 
SET GRAPHTEXT FONT GRID, 5-87, 3-33 
SET GRAPHTEXT PRECISION, 5-89, 3-8 
SET GRAPHTEXT ROTATION, 5-90, 3-8 
SET GRAPHTEXT SIZE, 5-91 , 3-8 
SET GRAPHTEXT SLANT, 5-92, 3-8 
SET PIVOT POINT, 5-97 , 3-33 

Gray mode, 5-67 

Gridding, 5-82 

Handshaking, 2-3 

protocol, 2-4 
HARDCOPY, 5-32 
HELP, 5-32 

HLS color system, 5-67, 3-26 
Home, 3-4 

Horizontal and Vertical Position (HVP), 4-12 
Horizontal Tab Character (HT), 4-1 2 
Horizontal Tab Set (HTS), 4-1 2 
Host communications, 2-1 — 2-6 
Host macros, 3-31 , 5-30 
Host syntax form, 5-6 
h t (Horizontal Tab character), 4-1 2 
HTS (Horizontal TabSet), 4-12 
Hue, 5-67 
HVP (Horizontal and Vertical Position), 4-12, 4-2 
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ICH (Insert character), 4-1 3 

IDENTIFY, 4-27 

Identify Terminal (TEKID), 4-22 

IGNORE DELETES, 2-3, 5-32 

IL (Insert Line), 4-13 

INCLUDE COPY OF SEGMENT, 5-33, 3-1 1,3-12 

Inclusion set, 5-69 

IND (Index), 4-1 3 

Index (IND), 4-13 

Indices 

background, 4-18, 4-19. See also Wipe index. 

border, 5-118 

erase, 4-18, 4-19 

foreground, 4-18, 4-19 

wipe, 5-118 
Inking, 5-83 
Input queue, 2-3 
Insert Character (ICH), 4-1 3 
Insert Line (IL), 4-13 
Insert/Replace mode (IRM), 4-15, 4-16 
Insertion commands, ANSI 

ICH (Insert Character), 4-1 3 

IL (Insert Line), 4-13 
Integer array parameter (Host), 5-3 
Integer array parameter (Setup), 5-3 
Integer parameter (Host), 5-2 
Integer parameter (Setup), 5-3 
Integer report parameter (Host), 5-6 
Integers in parameters, 4-6 
IRM (Insert/Replace mode), 4-15, 4-16 
ISO 6429, 4-1 

KAM (Keyboard Action mode), 4-15,4-16 
Key-execute character, 3-32, 5-16, 5-92 
Key macros, 3-31 — 3-32, 5-16, 5-30 

disabling, 3-31 

enabling, 3-31 

local, 3-32 
Key specifier parameter (Setup), 5-2 
Keyboard Action mode (KAM), 4-15, 4-16 
Keyboard, 1-3 

disabling, 4-1 1 , 5-34 

enabling, 4-12, 5-34 
Keypad Application mode (TEKKPAM), 4-23 
Keypad mode, 4-5, 4-26 

application, 4-23 

numeric, 4-23 

programming codes, 4-23 
Keyword parameter (Setup), 5-2 



LEARN /NVLEARN, 5-33 

l f (Linefeed character), 4-1 3 

LFCR, 5-34 

Lightness, 5-67 

Line of data, 2-5 

Line of text, 2-5 

Line style, 5-93 

Linefeed character ( l f), 4-1 3 

Linefeed/Newline mode (LNM), 4-1 5,4-16 

Lines, 3-5 

attributes of, 3-6 

double height, 4-22 

double width, 4-22 

single width, 4-24 
LNM (Linefeed/Newline mode), 4-15, 4-16 
LOCAL, 5-34 
Local mode, 2-1 , 5-34 
Locator function, 5-24 
LOCK KEYBOARD, 5-34 
LOCK VIEWING KEYS, 5-35, 5-54, 3-16 

MACRO STATUS, 5-35 
Macros, 3-31 — 3-32 

key macro charts, A-3 — A-8 

creating, 5-15 

deleting, 5-15 

host, 3-31 , 5-30 

key, 3-31— 3-32,5-16,5-30 

macro number, 3-31 

nonvolatile, 3-32, 5-15 

volatile, 3-32, 5-15 
Major modes 

Ansi, 4-4, 1-4 

Edit, 4-5, 1-4 

Tek,5-1,1-4 

VT52, 4-5, 1-4 
MAP INDEX TO PEN, 5-36, 2-7 
Margins, edit, 4-2, 4-24 
Marker mode, 3-6, 5-29 
Markers, 3-6 

Maximum color index, 5-114 
Memory 

nonvolatile, 5-58 

off-screen, 3-34 

raster, 3-20, 3-34 
Mode setting and resetting, 4-14 — 4-16, 4-20 
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Modes, 1-4,4-4 — 4-5 

Alpha, 5-28 

Alternate Keypad, 4-5, 

ALU, 3-34, 5-12 

Ansi, 1-4,4-4 

Ansi-to-VT52 (TEKANM), 4-15, 4-16 

Autorepeat (TEKARM), 4-15, 4-16 

Autowrap (TEKAWM), 4-1 5,4-16 

Bypass, 2-2, 5-29 

Color overlay, 5-67, 5-68 

Color specifying, 5-67 

Column (TEKCOLM), 4-15, 4-16 

Cursor Keys (TEKCKM), 4-15, 4-16 

Edit, 4-1, 4-5 

Graphics, 4-5 

Gray, 5-67 

Insert/Replace (IRM), 4-15, 4-16 

Keyboard Action (KAM), 4-15, 4-16 

Linefeed/Newiine (LNM), 4-15, 4-16 

Local, 2-1, 5-34 

Marker, 5-29 

Origin, 4-2, 4-15, 4-16 

Overstrike, 5-31 

Overstrike/Replace (TEKORM), 4-15, 4-16 

Pan, 5-35 

Prompt, 2-4, 5-39 

Replace, 5-31 

Screen (TEKSCNM), 4-15, 4-16 

Screen editing, 4-4 

Send/Receive (SRM), 4-15, 4-16 

Setup, 1-4,2-1 

Snoopy, 5-112 

Tek, 1-4 

Vector, 5-29 

VT52, 1-4,4-1,4-5 

Zoom, 5-35 
MOVE, 5-36, 3-5, 3-6 
Multiple panel boundaries, 5-10 
Multiple views. See Views. 

NEL (Next Line), 4-1 3 

Next Line (NEL), 4-1 3 

Nonvolatile memory, 5-58 

Normalized screen coordinate space, 5-120 

Norwegian character set, 4-1 7, A-7 

Numeric keypad, 4-5, 4-26 

mode, 4-23 

programming codes, 4-23 
NVLEARN, 5-33 



Odd parity, 5-94 

Off-screen memory, 3-34 

Origin mode, 4-2, 4-15, 4-16 

Output queue, 2-5 

Overstrike mode, 5-31 

Overstrike/Replace mode (TEKORM), 4-15, 4-16 

PAGE, 5-37 
Pan, 3-16 

lock and unlock, 5-35 

mode, 5-35 
Pan key, 3-1 6 
Panels, 3-3 

boundary line, 3-7 

creating, 3-7 

defining, 5-10 

filling, 3-7 
Parameter types (4100-style), 5-1 

character (Setup), 5-1 

character array (Host), 5-1 

integer (Host), 5-2 

integer (Setup), 5-3 

integer array (Host), 5-3 

integer array (Setup), 5-3 

integer report (Host), 5-6 

key specifier (Setup), 5-2 

keyword (Setup), 5-2 

real (Host), 5-3 

real (Setup), 5-4 

small integer (Host), 5-3 

small integer (Setup), 5-1 

string (Setup), 5-1 

xy-coordinates (Host), 5-4 
Parameters for setting and resetting modes, 4-1 6 
Parity, 2-2, 5-94 

even, 5-94 

odd, 5-94 

port, 2-7, 5-1 00 
Peripheral interface, 2-7 
Pick aperture, 3-30, 5-95 
Pick function, 3-29, 5-24 
Pick identification number, 3-1 1 , 3-29, 5-96 
Pick-ID, 3-1 1 , 3-29, 5-96 
Pivot point, 3-10, 3-33, 5-97 
Pixel, 3-20, 3-34 

copying, 5-37 
Pixel beam, position of, 3-36, 5-97 
PIXEL COPY, 5-37, 3-35 
Pixel operations, 3-34 — 3-36 
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Pixel operations commands 

BEGIN PIXEL OPERATIONS, 5-12, 3-35 

PIXEL COPY, 5-37, 3-35 

RASTER WRITE, 5-40, 3-35 

RECTANGLE FILL, 5-42, 3-35 

RUNLENGTH WRITE, 5-58 , 3-35 

SET PIXEL BEAM POSITION, 5-97, 3-35 

SET PIXEL VIEWPORT, 5-98, 3-35 
PLOT, 5-38,2-7 
PORT ASSIGN, 5-39, 2-7 
Port communications, 2-7 
Port communications commands 

COPY, 5-14, 2-7 

MAP INDEX TO PEN, 5-36, 2-7 

PLOT, 5-38, 2-7 

PORT ASSIGN, 5-39, 2-7 

REPORT PORT STATUS, 5-50, 2-6, 2-7 

SET PORT BAUD RATE, 5-98, 2-7 

SET PORT EOF STRING, 5-99, 2-7 

SET PORT FLAGGING MODE, 5-99, 2-7 

SET PORT PARITY, 5-100, 2-7 

SET PORT STOP BITS, 5-1 01 , 2-7 
Port end-of-file string, 5-99 
Port flagging, 5-99 
Port parity, 5-100 
Port Status Report, 5-50 
Position 

alpha cursor, 5-56 

current, 3-4 

cursor, 4-1 

graphics beam, 3-4 

graphics cursor, 5-56 

Home, 3-4 

pixel beam, 3-36, 5-97 

segment, 3-11,5-109 
Power-up condition, 4-14 
Power-up defaults, 5-58 
Precision 

string, 5-89 

stroke, 5-89 
Predefined fonts, 5-8 
Predefined graphtext fonts, 5-89 
Programming keys, 5-16 
Prompt mode, 2-4, 5-101 
PROMPT MODE, 5-39, 5-54, 2-5 
Prompt string, 2-4, 5-101 
Protocols 

plotter, 5-39 

pport, 5-39 



Queue 
input, 2-3 
output, 2-5 

Raster memory, 3-20, 3-34 
RASTER WRITE, 5-40, 3-36 
Rate 

baud, 2-1 

transmit, 2-1 
Real parameter 

Host, 5-3 

Setup, 5-4 
RECTANGLE FILL, 5-42, 3-35 
RENAME SEGMENT, 5-42, 3-12 
RENEW VIEW, 5-43 
Replace mode, 5-31 
REPORT 4010 STATUS, 5-56, 2-5 
Report commands, 2-5 — 2-6 

REPORT 4010 STATUS, 5-56, 2-5 

REPORT DEVICE STATUS, 5-43, 2-6 

REPORT ERRORS, 5-44, 2-6 

REPORT GIN POINT, 5-45, 2-6 

REPORT PORT STATUS, 5-50, 2-6, 2-7 

REPORT SEGMENT STATUS, 5-51 , 2-6 

REPORT SYNTAX MODE, 4-14, 4-28, 5-52, 2-6 

REPORT TERMINAL SETTINGS, 5-52, 2-6 
REPORT DEVICE STATUS, 5-43, 2-6 
REPORT ERRORS, 5-44, 2-6 
REPORT GIN POINT, 5-45, 2-6 
REPORT PORT STATUS, 5-50, 2-6, 2-7 
REPORT SEGMENT STATUS, 5-51 , 2-6 
REPORT SYNTAX MODE, 4-14, 4-28, 5-52, 2-6 
REPORT TERMINAL SETTINGS, 5-52, 2-6 
Reports, 2-5 — 2-6, 3-30 

Cursor Position, 4-8, 4-1 1 , 5-56 

Device Status, 4-1 1 , 5-43 

Error, 5-44 

GIN Locator, 5-48, 3-30 

GIN Pick, 5-48, 3-30 

GIN Stroke, 5-49, 3-30 

Port Status, 5-50 

Segment Status, 5-51 

Terminal Settings, 5-52 

4010 Status, 5-56 
Request to Send (RTS), 2-4 
RESET, 5-57 
Reset Modes (RM), 4-1 4 

RM parameters, 4-1 6 
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Reset to Initial State (RIS), 4-14 

Restore Cursor (TEKRC). 4-23 

Reverse Index (Rl), 4-14 

REVERSE LINEFEED, 4-28 

Reverse video display, 4-1 9 

RGB color system, 5-67 

Rl (Reverse Index), 4-14 

RIS (Reset to Initial State), 4-14 

RM (Reset Modes), 4-4, 4-14 — 4-16 

Rotation angle, graphtext, 5-90 

Row address, 4-1 

RTS (Request to Send), 2-4 

Rubberbanding, 5-84 

Rulings character set, 4-1 7, A-10 

Runcode, 3-36, 5-58 

RUNLENGTH WRITE, 5-58, 3-35, 3-36 

Saturation, 5-67 

Save Cursor (TEKSC), 4-24 

SAVE NONVOLATILE PARAMETERS, 5-58, 2-1 , 2-3, 3-3, 3- 

32 

s b (Sub character), 4-1 7 

Screen editing, 4-1 — 4-28 

concepts, 4-1 

modes, 4-4 

programs, 4-1 
Screen mode (TEKSCNM), 4-15, 4-16 
Scroll Down (SD), 4-1 7, 4-2 
Scroll Left (SL), 4-20 
Scroll Right (SR), 4-21 
Scroll Up (SU), 4-21 
Scrolling 

dialog area, 4-2 

SD 'Scroll Down* 4-1 7 

SL (Scroll Left), 4-20 

SR (Scroll Right), 4-21 

SU (Scroll Up), 4-21 
Scrolling region, 4-2 — 4-3 

edit margins, 4-2, 4-24 
SCS (Select Character Set), 4-17 
SD (Scroll Down), 4-17, 4-2 
Segment numbers, 3-10 

special, 3-13 
Segment Status Report, 5-51 



Segments, 3-10 

attributes of, 3-12 

changing size, 3-1 1 , 5-1 08 

classes, 3-13, 5-105 

commands, 3-12 

copying, 3-1 1 , 5-33 

defining, 3-10, 5-13 

highlighting, 3-12, 5-107 

including, 3-1 1 

matching class, 3-1 4 

moving, 3-11,5-108 

position, 3-11,5-109 

renaming, 5-42 

renumbering, 5-42 

rotating, 3-11,5-108 

scaling (sizing), 3-1 1 , 5-108 

visibility, 3-1 2, 5-110 

writing mode, 3-1 2, 5-1 1 1 
Segments commands 

BEGIN HIGHER SEGMENT 5-9, 3-12 

BEGIN LOWER SEGMENT, 5-9, 3-12 

BEGIN NEW SEGMENT, 5-10, 3-12 

BEGIN SEGMENT, 5-13, 3-12 

DELETE SEGMENT, 5-19, 3-12 

END SEGMENT, 5-28, 3-12 

INCLUDE COPY OF SEGMENT, 5-33, 3-12 

RENAME SEGMENT, 5-42, 3-12 

SET CURRENT MATCHING CLASS, 5-69, 3-12 

SET PICK ID, 5-96, 3-12 

SET PIVOT POINT, 5-97, 3-12 

SET SEGMENT CLASS, 5-1 05, 3-1 2 

SET SEGMENT DETECTABILITY, 5-105, 3-12 

SET SEGMENT DISPLAY PRIORITY, 5-106, 3-12 

SET SEGMENT HIGHLIGHTING, 5-107, 3-12 

SET SEGMENT IMAGE TRANSFORM, 5-1 07, 3-1 2 

SET SEGMENT POSITION, 5-1 09, 3-1 2 

SET SEGMENT VISIBILITY, 5-1 1 0, 3-12 

SET SEGMENT WRITING MODE, 5-111, 3-1 2 
Select Character Set (SCS), 4-1 7 
SELECT CODE, 4-18, 4-28, 5-59 
SELECT FILL PATTERN, 5-59, 3-7 
Select Graphic Rendition (SGR), 4-1 8,4-1 

parameters, 4-19 
SELECT HARDCOPY INTERFACE, 5-60 
SELECT VIEW, 5-60 
Send/Receive mode (SRM), 4-15, 4-16 
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SET 4014 ALPHATEXT SIZE 5-69, 3-14 

SET DIALOG AREA BUFFER SIZE, 5-69, 3-2, 3-3, 4-2 

SET DIALOG AREA COLOR MAP, 5-70, 3-3, 3-26, 3-27 

SET DIALOG AREA INDEX, 5-71 , 3-3 

SET DIALOG AREA LINES, 5-71 , 3-3, 4-2 

SET DIALOG AREA VISIBILITY, 5-72, 3-3 

SET DIALOG AREA WRITING MODE, 5-72, 3-3 

SET DIALOG HARDCOPY ATRIBUTES, 5-73 

SET ECHO, 5-74, 2-1 

SET EDIT CHARACTERS, 5-74 

SET EOF STRING, 5-75 

SET EOL STRING, 5-75, 2-5 

SET EOM CHARACTERS, 5-76, 2-5 

SET ERROR THRESHOLD, 5-76 

SET FIXUP LEVEL, 5-77 

SET FLAGGING MODE, 5-78, 2-4 

SET GIN AREA, 5-78, 3-30 

SET GIN CURSOR, 5-80 

SET GIN CURSOR COLOR, 5-81 , 3-30 

SET GIN DISPLAY START POINT, 5-82, 3-30 

SET GIN GRIDDING, 5-82, 3-30 

SET GIN INKING, 5-83, 3-30 

SET GIN RUBBERBANDING, 5-84, 3-30 

SET GIN STROKE FILTERING, 5-85, 3-30 

SET GIN WINDOW, 5-86, 3-30 

SET GRAPHICS AREA WRITING MODE, 5-86 

SET GRAPHTEXT FONT, 5-87, 3-8 

SET GRAPHTEXT FONT GRID, 5-87, 3-33 

SET GRAPHTEXT PRECISION, 5-89, 3-8 

SET GRAPHTEXT ROTATION, 5-90, 3-8 

SET GRAPHTEXT SIZE, 5-91 , 3-8 

SET GRAPHTEXT SLANT, 5-92, 3-8 

SET KEY EXECUTE CHARACTER, 5-92, 3-32 

SET LINE INDEX, 5-93, 3-6 

SET LINE STYLE, 5-93, 3-6 

SET MARKER TYPE, 5-94, 3-6 

Set Modes (SM), 4-20 

SM parameters, 4-16 
SET PARITY, 5-94, 2-2 
SET PICK APERTURE, 5-95, 3-30 
SET PICK ID, 5-96, 3-11, 3-12 
SET PIVOT POINT, 5-97, 3-1 0, 3-1 2 
SET PIXEL BEAM POSITION, 5-97, 3-35, 3-36 
SET PIXEL VIEWPORT, 5-98, 3-35 
SET PORT BAUD RATE, 5-98, 2-7 
SET PORT EOF STRING, 5-99, 2-7 
SET PORT FLAGGING MODE, 5-99, 2-7 
SET PORT PARITY, 5-100, 2-7 



SET PORT STOP BITS, 5-101 , 2-7 

SET PROMPT STRING, 5-101 , 2-5 

SET QUEUE SIZE, 5-1 02 

SET REPORT EOM FREQUENCY, 5-102 

SET REPORT MAX LINE LENGTH, 5-103 

SET REPORT SIG CHARACTERS, 5-104, 3-29 

SET SEGMENT CLASS, 5-105, 3-12, 3-14 

SET SEGMENT DETECTABILITY, 5-105, 3-12 

SET SEGMENT DISPLAY PRIORITY, 5-106 , 3-12 

SET SEGMENT HIGHLIGHTING, 5-1 07, 3-1 2 

SET SEGMENT IMAGE TRANSFORM, 5-107, 3-11,3-12 

SET SEGMENT POSITION, 5-1 09, 3-1 1 , 3-1 2 

SET SEGMENT VISIBILITY, 5-110,3-12 

SET SEGMENT WRITING MODE, 5-111, 3-1 2 

SET SNOOPY MODE 5-112 

SET STOP BITS, 5-1 12, 2-2 

SET SURFACE COLOR MAP, 5-113, 5-54, 3-22, 3-26, 3-27 

SET SURFACE DEFINITIONS, 5-114, 3-22 

SET SURFACE PRIORITIES, 5-1 1 5 

SET SURFACE VISIBILITY, 5-1 1 5 

SET TAB STOPS, 5-1 16 

SET TEXT INDEX, 5-1 16 

SET TRANSMIT DELAY, 5-1 1 7, 2-5 

SET TRANSMIT RATE LIMIT, 5-1 1 7, 2-1 

SET VIEW ATTRIBUTES, 5-118, 3-20 

SET VIEW DISPLAY CLUSTER, 5-1 1 9, 5-55, 3-20 

SET VIEWPORT, 5-120, 3-18 

SET WINDOW, 5-121, 3-16 

Setup command names 

ACURSOR, 5-61 

AUTOREPEAT,4-16 

AUTOWRAR4-16 

BACKINDICES, 5-63 

BAUDRATE, 5-64 

BEGINPANEL.5-10 

BORDER, 5-64 

BREAKTIME, 5-65, 2-2 

BYPASSCANCEL, 5-65 

CANCEL, 5-13 

CBACKGROUND, 5-62, 3-27 

CLEARDIALOG, 5-14, 3-3 

CMAR 5-1 13, 3-26, 3-27 

CMODE, 5-67, 3-26 

CODE, 4-1 8, 4-28, 5-59 

COLUMNMODE.4-16 

COPY, 5-14 

CRLF, 5-14,2-7 

CURSORKEYMODE, 4-16 
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Setup command names (cont) 
DABUFFER, 5-69, 3-2, 3-3 
DACMAR 5-70, 3-3, 3-26, 3-27 
DAENABLE, 5-22, 3-3 
DAINDEX, 5-71 , 3-3 
DALINES, 5-71 , 3-3 
DAMODE, 4-16, 5-72, 3-3 
DAVISIBILITY, 5-72, 3-3 
DEFINE, 5-15, 3-31,3-32 
DRAW, 5-21 , 3-6 
ECHO, 5-74, 2-1 
EDITCHARS, 5-74 
EDITMARGINS, 4-24, 4-2 
ENDPANEL,5-28 
EOFSTRING, 5-75 
EOLSTRING, 5-75, 2-5 
EOMCHARS, 5-76, 2-5 
ERRORLEVEL, 5-76 
EXPAND, 5-30, 3-31 
FACTORY, 5-31 
FILLPATTERN, 5-59 
FIXUP, 5-77 
FLAGGING, 5-78,2-4 
GAMODE, 5-86 
GCURSOR, 5-81 , 3-30 
GINAPERTURE, 5-95, 3-30 
GINAREA, 5-78, 3-30 
GINCURSOR, 5-80 
GINDISABLE, 5-20, 3-30 
GINENABLE, 5-23, 3-30 
GINFILTERING, 5-85, 3-30 
GINGRIDDING, 5-82, 3-30 
GININKING, 5-83, 3-30 
GINRUBBERBANDING, 5-84, 3-30 
GINSTARTPOINT, 5-82, 3-30 
GINWINDOW, 5-86, 3-30 
GTBEGIN, 5-8 
GTDELETE.5-19 
GTEND, 5-28 
GTEXT, 5-31 
GTFONT, 5-87 
GTGRID, 5-87 
GTINDEX,5-116 
GTPATH, 5-66 
GTPRECISION, 5-89 
GTROTATION, 5-90 
GTSIZE, 5-91 
GTSLANT, 5-92 



Setup command names (cont) 
HCDAATTRIBUTES, 5-73 
HCINTERFACE, 5-60 
HCSIZE, 5-68 
HELP, 5-32 
IGNOREDEL, 5-32 
KEYEXCHAR, 5-92 
KEYEXPAND,5-25 
KEYPADMODE, 4-23 
LEARN, 5-33, 3-32 
LFCR, 5-34 
LINEINDEX, 5-93 
LINESTYLE, 5-93 
LOCAL, 5-34 

LOCKVIEWINGKEYS, 5-35 
MACROSTATUS, 5-35 
MARKER, 5-21, 3-6 
MARKERTYPE, 5-94 
MOVE, 5-36 
NVDEFINE, 5-18, 3-31 
NVLEARN, 5-33, 3-32 
NVSAVE, 5-58, 3-32 
ORIGINMODE,4-16 
PARITY 5-94, 2-2 
PASSIGN, 5-39, 2-7 
PBAUD, 5-98, 2-7 
PBITS, 5-101, 2-7 
PEOF, 5-99, 2-7 
PFLAG, 5-99, 2-7 
PLOT , 5-38, 2-7 
PMAR 5-36, 2-7 
PPARITY, 5-100, 2-7 
PROMPTMODE, 5-39, 2-5 
PROMPTSTRING, 5-101 , 2-5 
PXBEGIN, 5-12, 3-35 
PXCOPY, 5-37, 3-35 
PXPOSITION, 5-97, 3-36 
PXRASTERWRITE, 5-40, 3-36 
PXRECTANGLE, 5-42, 3-35 
PXRUNLENGTHWRITE, 5-58, 3-36 
PXVIEWPORT, 5-98, 3-35 
QUEUESIZE, 5-102 
RENEW, 5-43 
REOM, 5-102 
RESET, 5-57 
RLINELENGTH, 5-103 
RSIGCHARS, 5-104 
SCREENMODE. 4-16 
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Setup command names (cont) 

SDEFINITIONS,5-114 

SELECTCHARSET,4-17 

SGCLASS, 5-105, 3-12, 3-14 

SGCLOSE, 5-28, 3-12 

SGDELETE, 5-19, 3-12 

SGDETECT, 5-105,3-12 

SGDOWN, 5-9, 3-12 

SGHIGHLIGHT, 5-107, 3-12 

SGINCLUDE, 5-33,3-12 

SGMATCHINGCLASS, 5-69, 3-12, 3-14 

SGMODE,5-111,3-12 

SGNEW, 5-9, 3-12 

SGOPEN, 5-13,3-12 

SGPICKID, 5-96, 3-12 

SGPIVOT, 5-97, 3-12 

SGPOSITION, 5-97, 3-12 

SGPRIORITY, 5-106, 3-12 

SGRENAME, 5-42, 3-12 

SGTRANSFORM, 5-107, 3-12 

SGUP, 5-9, 3-12 

SGVISIBILITY,5-110, 3-12 

SNOOPY, 5-1 12 

SPRIORITIES,5-115 

STATUS, 5-123 

STOPBITS,5-112,2-2 

SVISIBILITY,5-115 

TABS, 5-1 16 

TEXTRENDITION.4-18 

VDELETE, 5-20 

VDISPLAYCLUSTER, 5-119 

VIEWATTRIBUTES, 5-118, 3-20 

VIEWPORT, 5-120 

VSELECT, 5-60 

WINDOW, 5-121 

XMTDELAY,5-117,2-5 

XMTLIMIT,5-117,2-2 
Setup mode, 1-4,2-2 

syntax, 4-6, 5-6 
SGR (Select Graphic Rendition), 4-18, 4-1 

parameters, 4-19 
Shift In character ( s i), 4-20 
Shift Out character ( s o), 4-20 
s i (Shift In character), 4-20 
Signature characters, 3-29, 5-46, 5-104 
Single Width Line (TEKSWL), 4-24 



SL (Scroll Left), 4-20 
SM (Set Modes), 4-20, 4-4 
Small integer parameter 

Host, 5-3 

Setup, 5-1 
Snoopy mode, 5-112 
s o (Shift Out character), 4-20 
Source corners, 5-38 
s p (Space character), 4-21 
Space character ( s p), 4-21 
Spaces in syntax, 4-6, 5-7 
SR (Scroll Right), 4-21 
SRM (Send/Receive mode), 4-15, 4-16 
Standards 

ANSI X3 64, 4-1 

ISO 6429, 4-1 
Start point, 5-82 
STATUS, 5-123 
Stop bits, 2-2, 5-112 
String 

EOF (End-Of-File), 5-75 

EOL (End-Of-Line), 2-5, 5-75 

prompt, 2-4, 5-101 
String parameter (Setup), 5-1 
String precision graphtext, 3-8, 3-33, 5-31 
Stroke filtering, 5-85 
Stroke function, 5-24 

Stroke precision graphtext, 3-8, 3-33, 5-31 
SU (Scroll Up), 4-21 , 4-2 
Supplementary character set, 4-17, A-9 
Surfaces, 3-20 — 3-25 

creating multiple, 3-22 

priority of, 5-1 1 5 

visibility of , 5-115 
Swedish character set, 4-1 7, A-6 
Syntax conventions, 4-6, 5-6 

Ansi mode, 4-6 

bold type, 4-6, 5-7 

commas, 4-6, 5-7 

Host, 4-6, 5-6 

semicolons, 4-6 

Setup, 4-6, 5-6 

uppercase, 4-6 

VT52 mode, 4-6 

4100 commands, 5-6 — 5-7 
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Tab commands, ANSI 

CBT (Cursor Backward Tab), 4-8 

CHT (Cursor Horizontal Tab), 4-8 

h t (Horizontal Tab character), 4-1 2 

HTS (Horizontal Tab Set), 4-12 

TBC (Tab Clear), 4-21 

v t (Vertical Tab character), 4-24 
Tab Clear (TBC), 4-21 
Tab stops, 5-1 1 6 
TBC (Tab Clear), 4-21 
Tekmode, 1-4,5-1 

entering, 4-18, 4-28, 5-59 
Tek-private commands 

TEKDHL (Double Height Line), 4-22 

TEKDWL (Double Width Line), 4-22 

TEKID (Identify Terminal), 4-22 

TEKKPAM (Keypad Application Mode), 4-23 

TEKKPNM (Keypad Numeric Mode), 4-23 

TEKRC (Restore Cursor), 4-23 

TEKSC (Save Cursor), 4-24 

TEKSTBM (Set Top and Bottom Margins), 4-24 

TEKSWL (Single Width Line), 4-24 
TEKANM (Ansi-to-VT52 mode), 4-15, 4-16 
TEKARM (Autorepeat mode), 4-1 5, 4-1 6 
TEKAWM (Autowrap mode), 4-15, 4-16 
TEKCKM (Cursor Keys mode), 4-15, 4-16 
TEKCOLM (Column mode), 4-15, 4-16 
TEKDHL (Double Height Line), 4-22 
TEKDWL (Double Width Line), 4-22 
TEKID (Identify Terminal), 4-22 
TEKKPAM (Keypad Application Mode), 4-23 
TEKKPNM (Keypad Numeric Mode), 4-23 
TEKOM (Origin mode), 4-15, 4-16 

i ervvyriivi \vyvciou ii\c/ricpiciuc i iiuuc/, t-iO, n-iu 

TEKRC (Restore Cursor), 4-23 
TEKSC (Save Cursor), 4-24 
TEKSCMN (Screen mode), 4-15, 4-16 
TEKSTBM (Set Top and Bottom Margins), 4-24 
TEKSWL (Single Width Line), 4-24 
Terminal modes. See Modes. 
Terminal Settings Report, 5-52 
Terminal signature character, 5-48 
Terminal space, 3-4 

coordinates, 3-4 

unit, 3-4 
Terminal status, 5-56 
Time filter, 5-85 
Transmit delay, 2-4, 2-5, 5-1 1 7 



Transmit rate limits, 2-1 
Transparency, 3-3 
TSU. See Terminal space, unit. 
Turnaround character, 5-76 
Two-port peripheral interface, 2-7 

Underscore character 0, 4-24, 4-15,4-16 
Underscore display, 4-15, 4-19, 4-24 
United Kingdom character set, 4-17, A-4 

Vector mode, 3-5, 5-29 
Vertical Tab character ' v t^ 4-24 
View attributes, 3-20 

border index, 3-20 

surface, 3-20 

wipe index, 3-20 
View key, 3-16 
View, 3-1 8 

creating, 3-18, 5-60 

default, 5-61 , 3-1 9 

deleting, 3-19 

display clusters, 3-20, 5-1 1 9 

number, 3-18 

redrawing, 5-43 
Viewing Keys mode, 3-1 6 
Viewport, 3-18, 3-16, 5-120 

corners of, 3-18 

current, 3-1 6 

assigning to surfaces, 3-24 
v t (Vertical Tab character), 4-24 
VT52 commands 

CURSOR DOWN, 4-25 

CURSOR LEFT, 4-25 

n IDHCQ DlfiUT A OK 
*^wi iwwi i ■ h^ii i i, -r-cw 

CURSOR TO HOME, 4-25 

CURSOR UP, 4-25 

DIRECT CURSOR ADDRESS, 4-26 

ENTER ALTERNATE KEYPAD MODE, 4-26 

ENTER ANSI MODE, 4-26 

ENTER GRAPHICS MODE, 4-27 

ERASE TO END OF LINE, 4-27 

ERASE TO END OF SCREEN, 4-27 

EXIT ALTERNATE KEYPAD MODE, 4-27 

EXIT GRAPHICS MODE, 4-27 

IDENTIFY, 4-27 

REPORT SYNTAX MODE, 4-14, 4-28, 5-52 

REVERSE LINEFEED, 4-28 

SELECT CODE, 4-18, 4-28, 5-59 
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VT52 mode, 1 -4, 4-1 , 4-4, 4-5 

commands, 4-25 — 4-28 

command conventions, 4-6 

entering, 4-4, 4-15, 4-16, 4-18, 4-28, 5-59 
VT1 00, 4-1 , 4-4, 4-5, 4-10, 1-3 

Window specifier, 5-79 
Window, 3-16, 5-121 

corners of, 3-16 

default, 5-121 
Wipe index, 5-118 
Writing mode, segment, 5-1 1 1 

XY-coordinates (Host), 5-4 
Zoom key, 3-16 
Zoom, 3-16 

lock and unlock, 5-35 

mode, 5-35 
4010 GIN Report, 5-26 
4010 HARDCOPY, 5-123 
4010 Status Report, 5-56 

Alpha Cursor Position, 5-56 

Graphics Cursor Position, 5-56 

Terminal Status, 5-56 
(Underscore character), 4-24, 4-15, 4-16 
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COMMITTED TO EXCELLENCE 



product 4107/4109 PROGRAMMERS REFERENCE change reference C1 /' 1183 

uamiia. MDTMn 070-4893-00 11-23-83 

MANUAL PART NO. DATE 



EFFECTIVE ALL SERIAL NUMBERS 

TEXT CHANGES 

Please take the time to look through this package and make the 
indicated changes in your manual — these changes correct errors 
that may cause you difficulty. Changes to a sentence or 

£/<-*,j- <-*.g,4. ^11 Ctj. ^ iiX5iij.xgliuCU \JJ UilUCl XJLllXilg. 



THIS IS A PAGE REPLACEMENT PACKAGE. 



1 . Remove the appropriate pages from your manual and insert the attached pages. 

2. Keep this cover sheet in the Change Information section at the very back of this manual for a permanent 
record. 



p. 3-12 

Insert page 3-1 2a (at the back of this package) between pages 
3-12 and 3—1 3 - Page 3-1 2a contains a corrected version of Table 
3-2; cross out the original version on page 3-12. 

p. 4-21 

In the left column, change the last line to read: 

. . . bring the leftmost column into view. 

p. 5-16 

In the left column, just before the fourth paragraph, insert this 
sentence : 

Another way to define a key in Setup mode is by 
using the LEARN or NVLEARN command. See the 
LEARN/NVLEARN command description for details. 

p=5-20 

Insert page 5-20a (at the back of this package) between pages 5-20 and 
5-21. Page 5-20a contains the description of a new command, DIM 
ENABLE . 

p. 5-21 

In the left column, change the second sentence of the 
paragraph that begins "DRAW has the same effect ..." to include 
Edit and VT52 modes. It should read: 

The terminal can execute DRAW when it is in any mode except 
Ansi, Edit, VT52, or Bypass mode. 

In the right column, change the second sentence of the paragraph 
that begins "DRAW MARKER has the same effect ..." to include 
Edit and VT52 modes. It should read: 

The terminal can be in any mode except Ansi, Edit, VT52, 
or Bypass mode when it executes DRAW MARKER. 

In the right column, replace the last paragraph with this one: 

The terminal always draws markers in 
Overstrike mode. See the SET GRAPHICS AREA 
WRITING MODE command for details about how the 
Overstrike writing mode operates. 

p. 5-22 

In the left column, first sentence of the last paragraph, add 
Edit , arid VT52 after the word "Ansi" so that the sentence 
begins "In Ansi, Edit, and VT52 modes, the terminal ..." 



p. 5-31 

In the right column, fourth paragraph, put a period after the 
word "results", and delete the rest of the paragraph. 

p. 5-33 

In the right column, first paragraph following the syntax "box, 
change the second sentence to read; 

A key programmed with NVLEARN and saved with 
NVSAVE (SAVE NONVOLATILE PARAMETERS T 
remains programmed ... 

p. 5-35 

In the left column, delete references to a keyword in Setup 
syntax from the parameter description so that it reads: 

locking-mode: integer; one of the following: 

Unlocks the viewing keys 

1 Locks the viewing keys 
Defaults: Factory =0 

Power-Up = 

Om ■? + -I- a A _ A 

^>ili J. u UOU. — \J 

p. 5-37 

In the left column, delete the last item in the bulleted list 
(the item that begins "Cancels a command ..."). 

p. 5-44 

In the left column, second paragraph, change the word integer 
to integer-report . 

In the left column, change Bit 3 (B3) of Table 5-9 from X to C 
and change the list of bit meanings to read: 

X Reserved for the future 

C The copier is connected and powered up 

B The copier is busy 

P The copier interface is present 

p. 5-50 

In the left column, delete the words "or screen" from the 
sentence that precedes the syntax box. 

p. 5-56 

In the left column, delete both occurences of "EOM-indicator" in 
the indented lists. 

p. 5-57 

In the left column, delete the last paragraph. 



p. 5-58 

In the right column, expand the next-to-last paragraph to read: 

This command saves only parameters that have 
changed since the last time this command was 
issued. Additionally, this command saves any 
macros defined with a DEFINE NONVOLATILE MACRO or 
NVLEARN command. 

P. 5-62 

In the left column, delete the words small integer from the 
paragraph that begins with "font-code:". 

Following that paragraph, add this new paragraph: 

The character sets that are the current GO and GM 
sets can "be selected with the Ansi mode command 
SCS (Select Character Set) . 

p. 5-63 

In the left column, change the Setup name in the Setup Syntax box 

from BACKINDICES to BACKIHDEX. 

p. 5-64 

Insert page 5-64a (at the back of this package) between pages 
5-64 and 5-65 • Page 5-64a contains a new version of the 
parameter value list for the SET BORDER VISIBILITY command. 

p. 5-70 

In the left column, in the paragraph that begins "color-mixture:", 
delete the sentence that begins "Unlike other integer arrays ..." 

In the right column, delete the integer 4 from the Setup 
syntax example so the example reads: 

DACMAP 3 100 

Immediately following this example, delete the sentence that 
begins "The 4 indicates ..." 

p. 5-74 

Insert page 5-74a between pages 5-74 and 5-75- Page 5-74a 
contains a new version of the SET EDIT CHARACTERS command. Cross 
out the old version on page 5-74- 

p. 5-75 

In the left column, second paragraph after the Syntax boxes, 
delete the sentence that begins "When the terminal reaches the 
end ..." 



In the left column, change the sentence that precedes the Host 
Syntax "box to read: 

Specifies the character! s) used to terminate lines of text 
that the operator types. 

In the left column, seconu- oo-xatso ycungi a. y^, wieuxge v^w ^*~~ 
sentence to read: 

For example, in Prompt mode, when the operator 
types one of the end-of-message character(s) , 
the terminal stops transmitting . . . 

p . 5—84 

In the left column, change the Setup name in the Setup Syntax box 

In the left column, change the Setup name in the Setup Syntax "box 
from GIMPERTURE to GINPICKAPERTURE. 

In the right column, add 19,200 to the list of valid baud rates 
found in the "baud-rate parameter description. 

p ,5-1 03 

In the right column, delete the first two paragraphs. 

Insert page 5-1 1 6a between pages 5-116 and 5-117- Page 5-1 16a 
contains the description of the new command SET TABLET HEADER 
CHARACTERS. 

Y\ R— .1 1 ft 

In the left column, change the Setup name in the Setup Syntax box 
from VIEW ATTRIBUTES to YATTRIBUTES. 

n R— 1 1 Q 

In the left column, change the Setup name in the Setup Syntax box 
from YD IS PLAYC LUSTER to VCLUSTER. 



p.B-2 

Add this error code: 

IH1 1 (Level 2). Invalid parameter (must be or 1 ; 
in Setup syntax must be letters or control) . 

p.B-3 

Add these error codes: 

JQ1 1 (Level 2). Invalid device specifier. 

JQ12 (Level 3). Out of memory while parsing 
the first parameter. 

KG-11 (Level 2). Invalid dim-code (must be 
or 1 ) . 

KHOO (Level 2). Unrecognized command (you 
cannot make a small dialog copv with Katakana 
Option 4K) . 

p.B-4 

Change these error codes to read as follows: 

MC11 (Level 2). Invalid value in parameter 1 
(must be in range _0_ through 4095). 

MC21 (Level 2). Invalid value in parameter 2 
(must be in range _0_ through 4095). 

MC31 (Level 2). Invalid value in parameter 3 
(must be in range _p_ through 4095). 

p.B-5 

Change these error codes to read as follows: 

NU11 (Level 2). Invalid numeric equivalent of 
bypass-cancel character (must be in range 
through j_27) . 

PA11 (Level 2). Invalid port-identifier (must 
be PO: or P1 : ) , or port is busy . 

PB11 (Level 2). Invalid port-name (must be 
PO: or P1 : ) , or port is busy . 



p.B-6 

Change these error codes to read as follows: 

PE1 1 (Level 2). Invalid port-name (must be 
PO: or Pi i ) , or port is busy . 

PI 11 (Level 2). Invalid port-name (must be 
PO: or PI : ) , or port is busy . 

PR1 1 (Level 2). Invalid port-name (must be 
PO: or P1 : ) , or port is busy . 

PR21 (Level 2). Invalid baud rate (must be 
75, 110, 134, 150, 300, 600, 1200, 1800, 2000, 
2400, 4800, 9600, or 19200 ). 

T\ ,-. 1 „ -I- « „„„„— „„J„ TIT r\1 
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p.B-9 

Add this error code: 

SK1 3 (Level 2). Segment specified is an 
active GIN cursor. 



